Word-JavaScript-API – nur online verfügbarer Anforderungssatz

Beim WordApiOnline Anforderungssatz handelt es sich um einen speziellen Anforderungssatz, der Funktionen enthält, die nur für Word im Web verfügbar sind. APIs in diesem Anforderungssatz gelten als Produktions-APIs für die Word-Anwendung im Web. Sie befolgen die Supportrichtlinien von Microsoft 365 für Entwickler. 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 WordApiOnline Anforderungssatz auf allen Plattformen unterstützt werden, werden sie dem nächsten veröffentlichten Anforderungssatz hinzugefügt (WordApi 1.[NEXT]). Sobald dieser neue Anforderungssatz öffentlich ist, werden diese APIs aus WordApiOnlineentfernt. Stellen Sie sich dies als einen ähnlichen Werbeprozess wie eine API vor, die von der Vorschau 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 in Word im Web den Benutzern immer nur eine Version zur Verfügung steht, nämlich die neueste Version.

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

Funktionsbereich Beschreibung Relevante Objekte
Keine

Da WordApiOnline APIs nur von Word im Web unterstützt werden, sollte Ihr Add-In prüfen, ob der Anforderungssatz unterstützt wird, bevor diese APIs aufgerufen werden. Dadurch wird jeder Versuch vermieden, reine Online-APIs auf einer nicht unterstützten Plattform zu verwenden.

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. Testen Sie das Feature unbedingt auf diesen Plattformen, wenn Sie diese Änderung vornehmen.

Wichtig

Das Nur-Add-In-Manifest (XML) kann keine Desktop- oder Online-Anforderungssätze als Aktivierungsanforderungen angeben. Es ist kein gültiger Wert, der im Set-Element verwendet werden soll. Das einheitliche Manifest unterstützt reine Desktop-Anforderungssätze in der "requirements.capabilities" Eigenschaft.

API-Liste

In der folgenden Tabelle sind die Word-JavaScript-APIs aufgeführt, die WordApiOnline derzeit im Anforderungssatz 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

  • Last updated on