Mises à jour de l’API ONLYOFFICE : nouveautés de décembre 2025

La fin de l’année apporte une vague massive de mises à jour de l’API ONLYOFFICE. La version 9.2 d’ONLYOFFICE Docs est arrivée, et avec elle une extension significative de notre API JavaScript Office, de nouvelles fonctionnalités pour les plugins et les macros, ainsi que des améliorations essentielles de la documentation.

Pour les développeurs qui s’appuient sur ONLYOFFICE, ces mises à jour offrent un contrôle plus précis sur les éléments des documents, une manipulation améliorée des formulaires et de meilleurs outils d’intégration. Que vous automatisiez la création de documents, développiez des plugins complexes ou intégriez DocSpace, cette version a quelque chose à vous offrir. Plongeons-nous dans les détails techniques.

API JavaScript Office : contrôle étendu

L’API JavaScript Office a reçu un nombre important de nouvelles méthodes dans toute la suite.

Manipulation améliorée des formulaires

Le traitement programmatique des formulaires est désormais plus performant. Nous avons introduit de nouvelles méthodes pour gérer les éléments de formulaire avec précision.

Méthodes CheckBoxForm. Vous pouvez désormais gérer dynamiquement les étiquettes des cases à cocher dans l’API Form et l’API Text Document :

• ApiCheckBoxForm/GetLabel
• ApiCheckBoxForm/SetLabel

Gestion du cycle de vie et des identifiants. Nous avons normalisé la manière dont vous interagissez avec les objets de formulaire. De nouvelles méthodes Delete et GetInternalId ont été ajoutées pour pratiquement tous les types de formulaires dans l’API Formulaire et l’API Document texte. Cela inclut :

• ApiCheckBoxForm
• ApiComboBoxForm
• ApiComplexForm
• ApiDateForm
• ApiFormBase
• ApiPictureForm
• ApiTextForm

Ce contrôle granulaire permet d’obtenir un code plus propre lors de la gestion de formulaires dynamiques, en vous permettant de supprimer des éléments ou de les référencer par des identifiants internes de manière programmatique.

Méthodes de paragraphe pour les API de présentations et de feuilles de calcul

L’une des principales nouveautés de cette mise à jour est l’extension des méthodes ApiParagraph aux API de présentations et de feuille de calculs. Auparavant, la manipulation approfondie des paragraphes relevait principalement du domaine de l’API de document texte. Désormais, vous pouvez appliquer des mises en forme de texte enrichi et des modifications structurelles directement dans les diapositives et les feuilles de calcul.

• Structure : InsertParagraph, Push, Last, GetLastRunWithText.
• Mise en forme : SetBold, SetItalic, SetUnderline, SetStrikeout, SetDoubleStrikeout, SetCaps, SetSmallCaps.
• Style : SetColor, SetFontSize, SetFontFamily, SetSpacing.
• Propriétés : GetFontNames, SetTextPr.
• Données : ToJSON, GetInternalId.

Cela uniformise l’expérience développeur entre les différents éditeurs, rendant votre code plus réutilisable, que vous génériez un rapport dans un document ou que vous formatiez une zone de texte dans une présentation.

Aides à la conversion d’unités

Le traitement des mesures dans Office Open XML nécessite souvent une conversion entre les unités métriques anglaises (EMU) et les unités standards. Nous avons ajouté des méthodes d’aide aux API de présentations, de feuilles de calcul et de documents texte afin de simplifier cette opération :

• Api/EmusToMillimeters
• Api/MillimetersToEmus

Navigation et accès au contenu

Pour l’API de documents texte, nous avons amélioré le déplacement du curseur et l’insertion de contenu, ce qui est crucial pour les macros qui automatisent la saisie ou l’édition :

• ApiDocument/MoveCursorDown, MoveCursorLeft, MoveCursorRight, MoveCursorUp
• ApiDocument/EnterText
• ApiDocument/InsertParagraphBreak

De plus, l’accès au contenu des présentations et des feuilles de calcul est facilité grâce aux nouvelles méthodes ApiDocumentContent telles que GetAllParagraphs, GetCurrentParagraph et GetText.

Consulter la liste complète des nouvelles méthodes

Plugins pour Docs : une meilleure expérience de développement

La création de plugins ne se limite pas au code ; elle concerne également l’expérience du développeur et l’interface utilisateur finale.

Tutoriels de débogage

Nous avons ajouté une nouvelle sous-section Débogage à nos tutoriels pour les éditeurs Web et de bureau. Ces guides vous aideront à dépanner vos plugins plus rapidement et plus efficacement.

Cohérence de l’interface utilisateur

• Icônes : nous avons mis à jour la page Icônes du plugin avec les meilleures pratiques. L’ajout d’icônes est une petite étape qui améliore considérablement la convivialité et rend votre interface intuitive.
• Thèmes : une nouvelle page « Comment personnaliser les thèmes » explique comment votre plugin peut détecter le thème actuel de l’éditeur et réagir en conséquence. Cela garantit que votre plugin a un aspect natif, que l’utilisateur soit en mode sombre ou en mode clair.

Dépannage de la localisation

Nous avons ajouté une section Dépannage à la page Localisation afin de vous aider à résoudre les problèmes courants rencontrés lors de la traduction de vos plugins destinés à un public international.

Mises à jour du SDK DocSpace

Pour les développeurs qui intègrent notre plateforme de collaboration en salle DocSpace, le SDK JavaScript a été mis à jour. La structure de la documentation a été refondue et est désormais générée automatiquement à partir des fichiers provenant directement de DocSpace, ce qui garantit que la référence que vous consultez est toujours synchronisée avec le code réel.

Améliorations apportées au site de documentation API

Nous améliorons constamment le site de documentation API afin de le rendre plus rapide et plus facile à utiliser.

• Moteur : nous avons mis à jour Docusaurus vers la version 3.9.2.
• Mode thème système : le site de documentation prend désormais en charge la détection du thème système, en respectant vos préférences d’OS pour le mode sombre ou clair.
• Utilisation et localisation : nous avons repensé la page d’accueil de la documentation et amélioré la documentation en chinois, notamment la section Éditeurs de bureau entièrement traduite.