Nouvelles mises à jour de l'API de l'éditeur en ligne pour les documents ONLYOFFICE Docs

Tour d'horizon des améliorations

L'éditeur en ligne pour les documents ONLYOFFICE Docs introduit de nouvelles mises à jour de l’API : tour d'horizon des améliorations

L’équipe de développement d’ONLYOFFICE a récemment introduit de nombreuses améliorations à son API, destinées à enrichir les possibilités d’intégration, à faciliter la personnalisation des éditeurs et à renforcer la sécurité des environnements collaboratifs. Ces changements offrent aux développeurs davantage de souplesse pour répondre à des cas d’usage variés, allant de la gestion documentaire à l’intégration dans des solutions métier complexes.

Prise en charge étendue des formats de fichiers

L’API Docs prend désormais en charge des formats de fichiers supplémentaires, offrant une plus grande compatibilité, afin de garantir une expérience transparente aux utilisateurs travaillant avec des types de fichiers variés. Il s’agit notamment des formats Apple iWork et Hancom Office :

• pages
• key
• numbers
• hwp
• hwpx

Ces formats peuvent être spécifiés à l’aide de la propriété documentType, par exemple :


Options de personnalisation améliorées

Les développeurs ont désormais plus de contrôle sur le comportement et l’apparence de l’éditeur. Les principales mises à jour sont les suivantes :

• Masquer les conseils sur les fonctionnalités
  
  Le paramètre editorConfig.customization.features.featuresTips permet d’activer ou de désactiver les infobulles sur les nouvelles fonctionnalités lors du premier chargement de l’éditeur à la suite d’une mise à jour. La valeur par défaut est true.
• Afficher les barres de défilement de la feuille de calcul
  
  À partir de la version 8.3, il est possible de définir si le défilement horizontal/vertical est automatiquement affiché ou caché lorsque l’éditeur de feuilles de calcul est chargé. Vérifiez editorConfig.customization.showHorizontalScroll et editorConfig.customization.showVerticalScroll pour contrôler ces paramètres.
• Arrière-plan du diaporama de la présentation
  
  Utilisez le paramètre editorConfig.customization.slidePlayerBackground pour définir la couleur d’arrière-plan du diaporama aux formats HEX, RVB ou RGBA. Par exemple, #ff0000, rgb(255, 0, 0), rgba(255, 0, 0, 0.5).
  
  

  Code :

  Sélectionner tout

  1
  2
  3
  showHorizontalScroll: true,
        showVerticalScroll: true,
        slidePlayerBackground: "#000000",

• Couleurs des en-têtes de documents
  
  Personnalisez les styles d’en-tête dans l’éditeur de documents avec le paramètre editorConfig.customization.wordHeadingsColor, qui permet de spécifier des couleurs HEX.
• Bouton Mobile Info
  
  Permettez l’affichage du bouton Informations sur le document pour les éditeurs mobiles utilisant editorConfig.customization.mobile.info. La valeur par défaut est false.
• Mode pointeur
  
  Ajustez le mode du pointeur (sélection ou main) dans le visualiseur de présentation à l’aide du paramètre editorConfig.customization.pointerMode. La valeur par défaut est select.
  
  
• Barre d’outils compacte pour le visualiseur
  
  Le paramètre editorConfig.customization.compactToolbar prend désormais en charge le mode d’affichage, permettant de basculer entre les barres d’outils complète et compacte. La valeur par défaut du mode de visualisation est true.

Fonctions de sécurité améliorées

L’API Docs introduit la gestion des fichiers protégés par un mot de passe grâce à l’événement events.onUserActionRequired. La fonction est appelée lorsqu’une action de l’utilisateur est requise pour ouvrir un document dans les cas suivants :

• lorsque l’utilisateur doit saisir un mot de passe pour ouvrir le document protégé ;
• lorsque l’utilisateur doit sélectionner un encodage pour le fichier TXT ;
• lorsque l’utilisateur doit sélectionner un encodage et un délimiteur pour le fichier CSV.

Voici un exemple du fonctionnement de l’événement :



Par ailleurs, vous pouvez désormais utiliser la commande drop pour interdire l’édition de documents à des utilisateurs spécifiques :



La liste complète des modifications apportées à l’API Docs est disponible ici.

Obtenez la dernière version de ONLYOFFICE Docs Developer.

Nouvelles méthodes de l’API Office

L’API Office reçoit des mises à jour importantes pour une meilleure gestion des documents, notamment :

• Signets
• Contrôles du contenu
• Sections
• Filtres automatiques
• Sélection
• Et plus encore

Ces améliorations permettent des interactions et des expériences d’édition plus riches. Pour une description détaillée des commandes, consultez le journal des modifications de l’API Office.

Mises à jour de l’API des plugins

Plusieurs nouvelles méthodes et propriétés élargissent les capacités des plugins :

• Recherche de contenu
  
  La méthode GetSelectedContent permet de récupérer un contenu sélectionné dans un format spécifié.
  expression.GetSelectedContent(prop);
• Messages d’erreur
  
  La méthode ShowError permet aux plugins d’afficher des messages d’erreur ou d’avertissement.
  expression.ShowError(error, level);
• Propriétés du contrôle de contenu amélioré
  
  Les nouvelles propriétésShd (ombrage d’arrière-plan) et Border améliorent l’objet ContentControlProperties pour une meilleure personnalisation visuelle.
• Activation du panneau
  
  Le paramètre isActivated vous permet de spécifier si un panneau de plugin créé est développé (true) ou réduit (false) au chargement.

Consultez la liste complète des mises à jour de l’API du plugin.