Modèle d’objet JavaScript Word dans les compléments Office

  • Article

Cet article décrit les concepts fondamentaux de l’utilisation de l’API JavaScript Word pour créer des compléments.

Importante

Pour en savoir plus sur la nature asynchrone des API Word et la manière dont elles fonctionnent avec le document, consultez Utilisation du modèle d’API spécifique à l’application.

API Office.js pour Word

Un complément Word interagit avec les objets dans Word à l’aide de l’API JavaScript Office. Cela inclut deux modèles objet JavaScript :

  • API JavaScript Word : l’API JavaScript Word fournit des objets fortement typés qui fonctionnent avec le document, les plages, les tables, les listes, la mise en forme, etc.

  • API communes : les API communesdonnent accès à des fonctionnalités telles que l’interface utilisateur, les boîtes de dialogue et les paramètres client communs à plusieurs applications Office.

Vous utiliserez probablement l’API JavaScript Word pour développer la majorité des fonctionnalités des compléments destinés à Word, vous utiliserez également des objets dans l’API commune. Par exemple :

  • Office.Context : l’objet Context représente l’environnement d’exécution du complément et donne accès aux objets clés de l’API. Il se compose de détails sur la configuration du document comme contentLanguage et officeTheme, et fournit des informations sur l’environnement d’exécution du complément comme host et platform. En outre, il fournit la méthoderequirements.isSetSupported(), que vous pouvez utiliser pour vérifier si un ensemble de conditions requises spécifié est pris en charge par l’application Word dans laquelle le complément est en cours d’exécution.
  • Office.Document : l’objet Office.Document fournit la getFileAsync() méthode , que vous pouvez utiliser pour télécharger le fichier Word où le complément est en cours d’exécution. Elle est distincte de la Word. Objet Document.

Différences entre l’API JS Word et les API courantes.

Modèle d’objet spécifique à Word

Pour comprendre les API Word, vous devez connaître la manière dont les composants d’un document sont liés les uns aux autres.

  • Le Document contient les Sections, ainsi que les entités de niveau document telles que les paramètres et les parties XML personnalisées.
  • Une Section contient un Corps.
  • Un Corps donne accès aux Paragraphes, ContentControls et Plage objets, entre autres.
  • Une Plage représente une zone contiguë de contenu, y compris du texte, un espace vide, des Tableaux et des images. Elle contient également la plupart des méthodes de manipulation de texte.
  • Une Liste représente le texte d’une liste numérotée ou une liste à puces.

Voir aussi