ONLYOFFICE Docs 9.0 pour les développeurs : mises à jour de l’API

1 juillet 2025Par Dasha

La dernière version d’ONLYOFFICE Docs est arrivée, pleine de mises à jour qui offrent plus de fonctionnalités, une meilleure personnalisation et des performances améliorées. Si vous êtes un développeur ou un intégrateur recherchant à tirer parti des API améliorées, il y a beaucoup à explorer dans cette version. Découvrez tous les détails ci-dessous.

ONLYOFFICE Docs 9.0 for developers: API updates

Visionneuse de diagrammes

La nouvelle visionneuse de diagrammes est disponible pour le web, le bureau et le web mobile. Il permet d’ouvrir des fichiers de diagramme sans avoir recours à des applications tierces.

Où trouver dans l’API : le type de document du diagramme est ajouté au paramètre documentType.

ONLYOFFICE Docs 9.0 for developers: API updates

Prise en charge de nouveaux formats de fichiers

ONLYOFFICE continue d’étendre ses possibilités d’utilisation en prenant en charge de nouveaux formats de fichiers. Dans la version 9.0, il est possible d’ouvrir les fichiers Markdown et OpenDocument Graphic pour les visualiser.

Où trouver dans l’API : ajout de l’ouverture des formats odg et md.

De plus, avec le lancement de la visionneuse de diagrammes, nous avons ajouté la conversion des formats vsdm, vsdx, vssm, vssx, vstm et vstx. Vérifier l’API

ONLYOFFICE Docs 9.0 for developers: API updates

Options de personnalisation étendues

La personnalisation a atteint de nouveaux sommets dans la version 9.0, permettant à vos utilisateurs finaux d’adapter leur expérience ONLYOFFICE exactement comme ils le souhaitent.

Nouveaux thèmes d’interface utilisateur

Deux nouveaux thèmes, Clair moderne et Sombre moderne, sont présentés pour optimiser la recherche de chaque éditeur.

Où trouver dans l’API : Les identifiants des thèmes theme-white et theme-night sont ajoutés au paramètre editorConfig.customization.uiTheme.

const config = {
  editorConfig: {
    customization: {
...
      uiTheme: "theme-white",
...

ONLYOFFICE Docs 9.0 for developers: API updates

Sélection de la taille des polices pour l’interface utilisateur en chinois simplifié

Ce nouveau paramètre garantit une taille de police précise dans les mises en page en chinois simplifié, offrant ainsi la possibilité d’utiliser des styles occidentaux ou traditionnels.

Où trouver dans l’API : paramètre editorConfig.customization.forceWesternFontSize, la valeur par défaut est false.

const config = {
  editorConfig: {
    customization: {
....
 forceWesternFontSize: false,
...

Masquage des avatars des utilisateurs

Ce nouveau paramètre vous permet de masquer les avatars des utilisateurs dans l’en-tête de l’éditeur, ce qui contribue à créer une interface propre et sans distraction.

Où trouver dans l’API : paramètre editorConfig.customization.layout.header.user, la valeur par défaut est true.

const config = {
  editorConfig: {
    customization: {
...
layout: {
        header: {
          editMode: true,
          save: true,
          user: true,
          users: true,
        },

Amélioration des performances grâce au préchargement

À partir de la version 9.0, vous pouvez précharger les ressources statiques (HTML, CSS, JS, polices) dans le cache du navigateur avant d’ouvrir un fichier afin d’accélérer le chargement initial de l’éditeur de documents. Vérifier l’API

Deux options sont disponibles :

1) Utilisation du paramètre ?preload=placeholder

<div id="placeholder"></div>

<script type="text/javascript" src="https://documentserver/web-apps/apps/api/documents/api.js?preload=placeholder"></script>

2) Insertion manuelle d’une iframe de préchargement

<iframe src="https://documentserver/web-apps/apps/api/documents/preload.html" style="display:none;"></iframe>

Obtenez la dernière version de ONLYOFFICE Docs Developer :

TÉLÉCHARGER MAINTENANT

Amélioration de l’API pour les plugins et les macros

Boutons personnalisés pour les contrôles de contenu. Utilisez la classe Asc.ButtonContentControl pour créer des boutons uniques pour vos plugins. Définissez des actions à l’aide de la méthode attachOnClick et ajoutez vos propres icônes pour améliorer les fonctionnalités. Vérifier l’API

(function(window){
  window.Asc.plugin.init = function()
  {
    let button = new Asc.ButtonContentControl();
    button.icons = '/resources/check%scale%(default).png';
    button.attachOnClick(function(contentControlId){
      Asc.plugin.executeMethod("RemoveContentControl", [contentControlId]);
    });
 
    button = new Asc.ButtonContentControl();
    button.icons = '/resources/close%scale%(default).png';
    button.attachOnClick(function(contentControlId){
      Asc.plugin.executeMethod("RemoveContentControls", [[{"InternalId": contentControlId}]]);
    });
  }
})(window);

Définition de la diapositive active en fonction de son index. Accédez facilement à n’importe quelle diapositive dans les présentations grâce à la nouvelle méthode GoToSlide.

expression.GoToSlide(slideNumber);

Élément de liste de contrôle de contenu. L’introduction de l’énumération ContentControlListElement simplifie encore la gestion des contrôles de contenu dans les documents.

Calculs asynchrones. Gérez toute requête dans le corps d’une fonction personnalisée créée à l’aide de macros.

(function () {
  /**
   * World Bank indicator value for a specific year.
   * @customfunction

   * @param   {string} country   ISO-3 code, e.g. "TUR"
   * @param   {string} indicator Indicator code, e.g. "SP.POP.TOTL"
   * @param   {number} year      Four-digit year, e.g. 2024
   * @returns {any}             Numeric value or #N/A
   *
   * @example =WB("TUR","SP.POP.TOTL",2024)
   */
  async function WB(country, indicator, year) {
    // Build URL (World Bank allows CORS)
    const url =
      `https://api.worldbank.org/v2/country/${country}/indicator/${indicator}` +
      `?format=json&per_page=20000`;

    try {
      const r = await fetch(url);
      const [meta, data] = await r.json();

      // Find the row for the requested year
      const row = data.find((v) => v.date === year.toString());
      if (!row || row.value == null) return "#N/A";

      return row.value;               // resolves the Promise
    } catch (e) {
      return "#ERROR";
    }
  }

  // Register the function so it becomes a sheet formula
  Api.AddCustomFunction(WB);
})();

Nouveaux exemples

Avec la dernière mise à jour de la documentation de l’API, nous avons inclus encore plus d’exemples prêts à l’emploi pour Document Builder et les macros, ce qui rend votre processus de développement plus fluide et plus efficace.