ONLYOFFICE API-Updates: Was ist neu im Dezember 2025?

Zum Jahresende erscheint eine umfangreiche Aktualisierung der ONLYOFFICE API. Version 9.2 von ONLYOFFICE Docs ist da und bietet eine deutliche Erweiterung unserer Office JavaScript API, neue Funktionen für Plugins und Makros sowie wichtige Verbesserungen der Dokumentation.

Entwicklern, die auf ONLYOFFICE aufbauen, bieten diese Updates eine präzisere Steuerung von Dokumentelementen, verbesserte Formularbearbeitung und optimierte Integrationswerkzeuge. Ob Sie die Dokumenterstellung automatisieren, komplexe Plugins entwickeln oder DocSpace integrieren möchten – diese Version bietet für jeden etwas. Tauchen wir ein in die technischen Details.

Office JavaScript API: Erweiterte Steuerung

Die Office JavaScript API wurde um zahlreiche neue Methoden erweitert.

Verbesserte Formularbearbeitung

Die programmatische Bearbeitung von Formularen ist jetzt noch leistungsfähiger. Wir haben neue Methoden eingeführt, um Formularelemente präzise zu verarbeiten.

CheckBoxForm-Methoden. Sie können nun Beschriftungen für Kontrollkästchen sowohl in der Formular-API als auch in der Textdokument-API dynamisch verwalten:

• ApiCheckBoxForm/GetLabel
• ApiCheckBoxForm/SetLabel

Lebenszyklus- und ID-Management. Wir haben die Interaktion mit Formularobjekten standardisiert. Für nahezu jeden Formulartyp wurden in der Formular-API und der Textdokument-API neue Methoden zum Löschen und Abrufen der internen ID hinzugefügt. Dies umfasst:

• ApiCheckBoxForm
• ApiComboBoxForm
• ApiComplexForm
• ApiDateForm
• ApiFormBase
• ApiPictureForm
• ApiTextForm

Diese detaillierte Steuerung ermöglicht einen saubereren Code bei der Verwaltung dynamischer Formulare, da Sie Elemente programmgesteuert entfernen oder über interne IDs auf sie zugreifen können.

Absatzmethoden für die Präsentations- und Tabellenkalkulations-APIs

Eine der wichtigsten Neuerungen dieses Updates ist die Erweiterung der ApiParagraph-Methoden auf die Präsentations- und Tabellenkalkulations-APIs. Bisher war die detaillierte Bearbeitung von Absätzen hauptsächlich der Textdokument-API vorbehalten. Jetzt können Sie Rich-Text-Formatierungen und Strukturänderungen direkt in Folien und Tabellenblättern anwenden.

• Struktur: InsertParagraph, Push, Last, GetLastRunWithText.
• Formatierung: SetBold, SetItalic, SetUnderline, SetStrikeout, SetDoubleStrikeout, SetCaps, SetSmallCaps.
• Stil: SetColor, SetFontSize, SetFontFamily, SetSpacing.
• Eigenschaften: GetFontNames, SetTextPr.
• Daten: ToJSON, GetInternalId.

Dies vereinheitlicht das Entwicklererlebnis über alle Editoren hinweg und macht Ihren Code wiederverwendbarer, egal ob Sie einen Bericht in einem Dokument generieren oder ein Textfeld in einer Präsentation formatieren.

Hilfsfunktionen zur Einheitenumrechnung

Die Verarbeitung von Maßeinheiten in Office Open XML erfordert häufig die Umrechnung zwischen englischen metrischen Einheiten (EMUs) und Standardeinheiten. Um dies zu vereinfachen, haben wir den APIs für Präsentationen, Tabellenkalkulationen und Textdokumente Hilfsmethoden hinzugefügt:

• Api/EmusToMillimeters
• Api/MillimetersToEmus

Navigation und Inhaltszugriff

Für die Textdokument-API haben wir die Cursorbewegung und das Einfügen von Inhalten verbessert. Dies ist besonders wichtig für Makros, die das Tippen oder Bearbeiten automatisieren:

• ApiDocument/MoveCursorDown, MoveCursorLeft, MoveCursorRight, MoveCursorUp
• ApiDocument/EnterText
• ApiDocument/InsertParagraphBreak

Darüber hinaus ist der Zugriff auf Inhalte in Präsentationen und Tabellenkalkulationen mit neuen ApiDocumentContent-Methoden wie GetAllParagraphs, GetCurrentParagraph und GetText. einfacher.

Die vollständige Liste der neuen Methoden

Plugins für Docs: Optimiertes Entwicklererlebnis

Bei der Plugin-Entwicklung geht es um mehr als nur um Code; es geht um das Entwicklererlebnis und die finale Benutzeroberfläche.

Debugging-Tutorials

Wir haben unseren Tutorials für Web– und Desktop-Editoren einen neuen Abschnitt zum Thema Debugging hinzugefügt. Diese Anleitungen helfen Ihnen, Fehler in Ihren Plugins schneller und effektiver zu beheben.

UI-Konsistenz

• Icons: Wir haben die Seite „Plugin-Icons“ gemäß bewährter Methoden aktualisiert. Das Hinzufügen von Icons ist ein kleiner Schritt, der die Benutzerfreundlichkeit deutlich verbessert und Ihre Oberfläche intuitiv gestaltet.
• Themes: Auf der neuen Seite „Themes anpassen“ wird erklärt, wie Ihr Plugin das aktuelle Editor-Theme erkennt und entsprechend reagiert. So sieht Ihr Plugin immer nativ aus, egal ob der Benutzer den Dunkel- oder Hellmodus verwendet.

Fehlerbehebung bei der Lokalisierung

Wir haben der Lokalisierungsseite einen Abschnitt zur Fehlerbehebung hinzugefügt, der Ihnen hilft, häufige Probleme bei der Übersetzung Ihrer Plugins für ein internationales Publikum zu lösen.

Updates für DocSpace SDK

Für Entwickler, die unsere raumbasierte Kollaborationsplattform DocSpace integrieren, wurde das JavaScript SDK aktualisiert. Die Dokumentationsstruktur wurde überarbeitet und wird nun automatisch anhand von Dateien direkt aus DocSpace generiert. So ist sichergestellt, dass die Referenz stets mit dem aktuellen Code übereinstimmt.

Verbesserungen der API-Dokumentationsseite

Wir optimieren die API-Dokumentationsseite kontinuierlich, um sie schneller und benutzerfreundlicher zu gestalten.

• Engine: Docusaurus wurde auf Version 3.9.2 aktualisiert.
• Systemdesignmodus: Die Dokumentationsseite erkennt nun das Systemdesign und berücksichtigt die Einstellungen Ihres Betriebssystems (heller oder dunkler Modus)
• Benutzerfreundlichkeit & Lokalisierung: Die Startseite der Dokumentation wurde überarbeitet und die chinesische Dokumentation, einschließlich des vollständig übersetzten Abschnitts „Desktop-Editoren“, verbessert.