Word Nur-Online-Anforderungssatz der JavaScript-API

  • Artikel

Der WordApiOnline Anforderungssatz ist ein spezieller Anforderungssatz, der Features enthält, die nur für Word im Web verfügbar sind. APIs in diesem Anforderungssatz gelten als Produktions-APIs für die Word in der Webanwendung. Sie folgen den Microsoft 365-Entwicklersupportrichtlinien. WordApiOnline APIs gelten als "Vorschau"-APIs für andere Plattformen (Windows, Mac, iPad) und werden möglicherweise von keiner dieser Plattformen unterstützt.

Wenn APIs im Anforderungssatz WordApiOnline plattformübergreifend unterstützt werden, werden sie dem nächsten freigegebenen Anforderungssatz (WordApi 1.[NEXT]) hinzugefügt. Sobald diese neue Anforderung öffentlich ist, werden diese APIs aus WordApiOnlineentfernt. Stellen Sie sich dies als einen ähnlichen Heraufstufungsprozess für eine API vor, die von der Vorschauversion zur Veröffentlichung wechselt.

Wichtig

WordApiOnline ist eine Obermenge des letzten nummerierten Anforderungssatzes.

Wichtig

WordApiOnline 1.1 ist die einzige Version der nur online verfügbaren APIs. Dies liegt daran, dass Word im Web immer eine einzelne Version für Benutzer zur Verfügung stellt, die die neueste Version ist.

Die folgende Tabelle enthält eine kurze Zusammenfassung der APIs, während die nachfolgende API-Listentabelle eine detaillierte Liste der aktuellen WordApiOnline APIs enthält.

Funktionsbereich Beschreibung Relevante Objekte
Nichts.

Da WordApiOnline APIs nur von Word im Web unterstützt werden, sollte Ihr Add-In überprüfen, ob der Anforderungssatz unterstützt wird, bevor diese APIs aufgerufen werden. Dadurch wird vermieden, dass eine reine Online-API auf einer anderen Plattform aufgerufen wird.

if (Office.context.requirements.isSetSupported("WordApiOnline", "1.1")) {
   // Any API exclusive to the WordApiOnline requirement set.
}

Sobald sich die API in einem plattformübergreifenden Anforderungssatz befindet, sollten Sie die isSetSupported Überprüfung entfernen oder bearbeiten. Dadurch wird das Feature Ihres Add-Ins auf anderen Plattformen aktiviert. Stellen Sie sicher, dass Sie das Feature auf diesen Plattformen testen, wenn Sie diese Änderung vornehmen.

Wichtig

Ihr Manifest kann nicht als Aktivierungsanforderung angeben WordApiOnline 1.1 . Es ist kein gültiger Wert, der im Set-Element verwendet werden kann.

API-Liste

In der folgenden Tabelle sind die Word JavaScript-APIs aufgeführt, die derzeit im Anforderungssatz WordApiOnline enthalten sind. Eine vollständige Liste aller Word JavaScript-APIs (einschließlich WordApiOnline APIs und zuvor veröffentlichter APIs) finden Sie unter alle Word JavaScript-APIs.

Klasse Felder Beschreibung

Siehe auch