Word ensemble de conditions requises en ligne de l’API JavaScript uniquement
L’ensemble WordApiOnline de conditions requises est un ensemble de conditions requises spécial qui inclut des fonctionnalités qui ne sont disponibles que pour Word sur le web. Les API de cet ensemble de conditions requises sont considérées comme des API de production pour l’application Word sur le web. Ils suivent les stratégies de support pour les développeurs Microsoft 365.
WordApiOnline Les API sont considérées comme des API « en préversion » pour d’autres plateformes (Windows, Mac, iPad) et peuvent ne pas être prises en charge par l’une de ces plateformes.
Lorsque les API de l’ensemble WordApiOnline de conditions requises sont prises en charge sur toutes les plateformes, elles sont ajoutées à l’ensemble de conditions requises suivant (WordApi 1.[NEXT]). Une fois que ce nouvel ensemble de conditions requises est public, ces API sont supprimées de WordApiOnline. Considérez cela comme un processus de promotion similaire à celui d’une API passant de la préversion à la mise en production.
Importante
WordApiOnline est un sur-ensemble du dernier ensemble de conditions requises numérotées.
Importante
WordApiOnline 1.1 est la seule version des API en ligne uniquement. Cela est dû au fait que Word sur le web aura toujours une seule version disponible pour les utilisateurs qui est la dernière version.
Le tableau suivant fournit un résumé concis des API, tandis que le tableau de liste d’API suivant fournit une liste détaillée des API actuelles WordApiOnline .
| Fonctionnalité | Description | Objets pertinents |
|---|---|---|
| Aucune |
Utilisation recommandée
Étant donné que WordApiOnline les API ne sont prises en charge que par Word sur le web, votre complément doit case activée si l’ensemble de conditions requises est pris en charge avant d’appeler ces API. Cela évite toute tentative d’utilisation d’API en ligne uniquement sur une plateforme non prise en charge.
if (Office.context.requirements.isSetSupported("WordApiOnline", "1.1")) {
// Any API exclusive to the WordApiOnline requirement set.
}
Une fois que l’API est dans un ensemble de conditions requises multiplateforme, vous devez supprimer ou modifier le isSetSupported case activée. Cela permet d’activer la fonctionnalité de votre complément sur d’autres plateformes. Veillez à tester la fonctionnalité sur ces plateformes lors de cette modification.
Importante
Votre manifeste ne peut pas spécifier WordApiOnline 1.1 comme condition d’activation. Il ne s’agit pas d’une valeur valide à utiliser dans l’élément Set.
Liste des API
Le tableau suivant répertorie les Word API JavaScript actuellement incluses dans l’ensemble de WordApiOnline conditions requises. Pour obtenir la liste complète de toutes les API JavaScript Word (y compris WordApiOnline les API et les API précédemment publiées), consultez toutes les API JavaScript Word.
| Classe | Champs | Description |
|---|