Actualizaciones de la API de ONLYOFFICE: Novedades de diciembre de 2025

El final del año trae una enorme ola de actualizaciones a la API de ONLYOFFICE. Ya está disponible la versión 9.2 de ONLYOFFICE Docs y, con ella, llega una expansión significativa de nuestra API de Office JavaScript, nuevas capacidades para plugins y macros, y mejoras esenciales en la documentación.

Para los desarrolladores que construyen sobre ONLYOFFICE, estas actualizaciones ofrecen un control más granular sobre los elementos del documento, una manipulación de formularios más avanzada y mejores herramientas de integración. Ya sea que estés automatizando la creación de documentos, desarrollando plugins complejos o integrando DocSpace, esta versión tiene algo para ti. Entremos en los detalles técnicos.

API de Office JavaScript: control ampliado

La API de Office JavaScript ha recibido una gran cantidad de nuevos métodos en toda la suite.

Manipulación mejorada de formularios

Trabajar con formularios de forma programática ahora es mucho más potente. Se han introducido nuevos métodos para manejar los elementos de formularios con mayor precisión.

Métodos CheckBoxForm. Ahora puedes gestionar dinámicamente las etiquetas de las casillas de verificación tanto en la API de Formularios como en la API de Documentos de Texto:

• ApiCheckBoxForm/GetLabel
• ApiCheckBoxForm/SetLabel

Gestión del ciclo de vida e IDs. Se ha estandarizado la forma de interactuar con los objetos de formularios. Se han añadido nuevos métodos Delete y GetInternalId GetInternalId para prácticamente todos los tipos de formularios, tanto en la API de Formularios como en la API de Documentos de Texto. Esto incluye:

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

Este control granular permite un código más limpio al gestionar formularios dinámicos, facilitando la eliminación de elementos o su referencia mediante IDs internos de forma programática.

Métodos de párrafo para las APIs de presentaciones y hojas de cálculo

Una de las incorporaciones más importantes de esta actualización es la expansión de los métodos ApiParagraph a las APIs de presentaciones y hojas de cálculo. Anteriormente, la manipulación profunda de párrafos era principalmente dominio de la API de Documentos de Texto. Ahora puedes aplicar formato de texto enriquecido y cambios estructurales directamente dentro de diapositivas y hojas.

• Estructura: InsertParagraph, Push, Last, GetLastRunWithText.
• Formato: SetBold, SetItalic, SetUnderline, SetStrikeout, SetDoubleStrikeout, SetCaps, SetSmallCaps.
• Estilo: SetColor, SetFontSize, SetFontFamily, SetSpacing.
• Propiedades: GetFontNames, SetTextPr.
• Datos: ToJSON, GetInternalId.

Esto unifica la experiencia de desarrollo en todos los editores, haciendo que tu código sea más reutilizable, ya sea que estés generando un informe en un documento o dando formato a un cuadro de texto en una presentación de diapositivas.

Ayudantes para la conversión de unidades

El manejo de medidas en Office Open XML suele requerir la conversión entre English Metric Units (EMU) y unidades estándar. Hemos añadido métodos auxiliares a las APIs de presentaciones, hojas de cálculo y documentos de texto para simplificar este proceso:

• Api/EmusToMillimeters
• Api/MillimetersToEmus

Navegación y acceso al contenido

Para la API de documentos de texto, hemos mejorado el movimiento del cursor y la inserción de contenido, algo fundamental para los macros que automatizan la escritura o la edición:

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

Además, ahora es más fácil acceder al contenido dentro de presentaciones y hojas de cálculo gracias a nuevos métodos de ApiDocumentContent como GetAllParagraphs, GetCurrentParagraph, y GetText.

Consulta la lista completa de nuevos métodos

Plugins para Docs: mejor experiencia de desarrollo

Crear plugins no se trata solo del código, sino también de la experiencia del desarrollador y de la interfaz final para el usuario.

Tutoriales de depuración

Hemos añadido una nueva subsección de Depuración en nuestros tutoriales tanto para los editores web como de escritorio. Estas guías te ayudarán a resolver problemas en tus plugins de forma más rápida y eficaz.

Consistencia de la interfaz (UI)

• Iconos: Hemos actualizado la página de Iconos de plugins con buenas prácticas. Añadir iconos es un pequeño paso que mejora significativamente la usabilidad y hace que la interfaz sea más intuitiva.
• Temas: Una nueva página, “Cómo personalizar temas”, explica cómo tu plugin puede detectar el tema actual del editor y reaccionar en consecuencia. Esto garantiza que tu plugin se vea nativo, ya sea que el usuario esté en modo oscuro o claro.

Solución de problemas de localización

Hemos añadido una sección de Solución de problemas en la página de Localización para ayudarte a resolver inconvenientes comunes al traducir tus plugins para una audiencia global.

Actualizaciones del SDK de DocSpace

Para los desarrolladores que integran nuestra plataforma de colaboración basada en salas, DocSpace, el SDK de JavaScript ha sido actualizado. La estructura de la documentación se ha refactorizado y ahora se genera automáticamente utilizando archivos directamente desde DocSpace, lo que garantiza que la referencia que consultes esté siempre sincronizada con el código real.

Mejoras en el sitio de documentación de la API

Seguimos mejorando constantemente el sitio de documentación de la API para hacerlo más rápido y fácil de usar.

• Motor: Actualizamos Docusaurus a la versión 3.9.2.
• Modo de tema del sistema: El sitio de documentación ahora admite la detección del tema del sistema, respetando la preferencia de tu sistema operativo para modo oscuro o claro.
• Usabilidad y localización: Hemos rediseñado la página de inicio de la documentación y mejorado la documentación en chino, incluida la sección completamente traducida de Editores de Escritorio.