Aggiornamento delle API di ONLYOFFICE: quali sono le novità di dicembre 2025

La fine dell’anno porta un’ondata di aggiornamenti per l’ONLYOFFICE API. È arrivata la versione 9.2 di ONLYOFFICE Docs, con un’espansione significativa del nostro Office JavaScript API, nuove funzionalità per plugin e macro e importanti miglioramenti della documentazione.

Per gli sviluppatori che lavorano su ONLYOFFICE, questi aggiornamenti offrono un controllo più preciso sugli elementi dei documenti, una gestione avanzata dei moduli e strumenti di integrazione migliori. Che tu stia automatizzando la creazione di documenti, sviluppando plugin complessi o integrando DocSpace, questo rilascio ha qualcosa per te. Passiamo ai dettagli tecnici.

Office JavaScript API: controllo esteso

Office JavaScript API ha ricevuto un numero consistente di nuovi metodi in tutta la suite.

Gestione avanzata dei moduli

Lavorare con i moduli in modo programmato ora è più potente: sono stati introdotti nuovi metodi per gestire gli elementi dei moduli con precisione.

Metodi CheckBoxForm. Ora puoi gestire dinamicamente le etichette delle caselle di controllo sia nella Form API sia nella Text Document API:

• ApiCheckBoxForm/GetLabel
• ApiCheckBoxForm/SetLabel

Gestione ciclo di vita e ID. Abbiamo standardizzato il modo in cui interagisci con gli oggetti modulo. Nuovi metodi Delete e GetInternalId sono stati aggiunti praticamente per ogni tipo di modulo sia nella Form API sia nella Text Document API. Questo include:

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

Questo controllo granulare permette un codice più pulito nella gestione dei moduli dinamici, consentendo di rimuovere elementi o fare riferimento a loro tramite ID interni in modo programmato.

Metodi per paragrafi nelle Presentation e Spreadsheet API

Una delle aggiunte più importanti in questo aggiornamento è l’espansione dei metodi ApiParagraph alle Presentation e Spreadsheet API. In precedenza, la manipolazione approfondita dei paragrafi era principalmente dominio della Text Document API. Ora puoi applicare formattazioni di testo avanzate e modifiche strutturali direttamente in diapositive e fogli di calcolo.

• Struttura: InsertParagraph, Push, Last, GetLastRunWithText.
• Formattazione: SetBold, SetItalic, SetUnderline, SetStrikeout, SetDoubleStrikeout, SetCaps, SetSmallCaps.
• Stile: SetColor, SetFontSize, SetFontFamily, SetSpacing.
• Proprietà: GetFontNames, SetTextPr.
• Dati: ToJSON, GetInternalId.

Questo unifica l’esperienza dello sviluppatore tra gli editor, rendendo il codice più riutilizzabile sia che tu stia generando un report in un documento sia che stia formattando una casella di testo in una presentazione.

Helper per conversione unità

Gestire le misurazioni in Office Open XML spesso richiede la conversione tra English Metric Units (EMUs) e unità standard. Sono stati aggiunti metodi helper nelle Presentation, Spreadsheet e Text Document API per semplificare questa operazione:

• Api/EmusToMillimeters
• Api/MillimetersToEmus

Navigazione e accesso ai contenuti

Per la Text Document API, abbiamo migliorato il movimento del cursore e l’inserimento dei contenuti, essenziale per macro che automatizzano la digitazione o la modifica:

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

Inoltre, accedere ai contenuti all’interno di presentazioni e fogli di calcolo è più semplice con i nuovi metodi ApiDocumentContent come GetAllParagraphs, GetCurrentParagraph e GetText.

Consulta l’elenco completo dei nuovi metodi

Plugin per Docs: migliore esperienza per sviluppatori

Creare plugin non significa solo scrivere codice; riguarda l’esperienza dello sviluppatore e l’interfaccia finale per l’utente.

Tutorial di debugging

Abbiamo aggiunto una nuova sottosezione Debugging ai nostri tutorial per entrambi web e desktop editors. Queste guide aiutano a risolvere problemi con i plugin in modo più rapido ed efficace.

Coerenza UI

• Icone: Abbiamo aggiornato la pagina delle icone dei plugin con le migliori pratiche. Aggiungere icone è un piccolo passo che migliora notevolmente l’usabilità e rende l’interfaccia intuitiva.
• Temi: Una nuova pagina “Come personalizzare i temi” spiega come il plugin può rilevare il tema attuale dell’editor e adattarsi di conseguenza, garantendo un aspetto nativo sia in Dark Mode che Light Mode.

Risoluzione problemi di localizzazione

Abbiamo aggiunto una sezione Troubleshooting nella pagina Localizzazione per aiutare a risolvere problemi comuni durante la traduzione dei plugin per un pubblico globale.

Aggiornamenti DocSpace SDK

Per gli sviluppatori che integrano la nostra piattaforma di collaborazione basata su stanze DocSpace, il JavaScript SDK è stato aggiornato. La struttura della documentazione è stata rifattorizzata e viene ora generata automaticamente dai file direttamente da DocSpace, garantendo che le informazioni siano sempre aggiornate con il codice reale.

Miglioramenti al sito di documentazione API

Stiamo continuamente migliorando il sito di documentazione API per renderlo più veloce e facile da usare.

• Motore: Abbiamo aggiornato Docusaurus alla versione 3.9.2.
• Modalità tema di sistema: Il sito di documentazione supporta ora il rilevamento del tema di sistema, rispettando le preferenze del tuo OS per modalità scura o chiara.
• Usabilità e localizzazione: Abbiamo ridisegnato la pagina iniziale della documentazione e migliorato quella cinese, inclusa la sezione Desktop Editors completamente tradotta.