Atualizações da API ONLYOFFICE: Novidades em dezembro de 2025

O final do ano traz uma grande onda de atualizações para a API do ONLYOFFICE. A versão 9.2 do ONLYOFFICE Docs já está disponível e traz uma expansão significativa da nossa API JavaScript do Office, novos recursos para plug-ins e macros, além de melhorias essenciais na documentação.

Para desenvolvedores que trabalham com o ONLYOFFICE, essas atualizações oferecem um controle mais granular sobre os elementos dos documentos, manipulação aprimorada de formulários e melhores ferramentas de integração. Se você está automatizando a criação de documentos, desenvolvendo plug-ins complexos ou integrando o DocSpace, esta versão tem algo a lhe oferecer. Vamos nos aprofundar nos detalhes técnicos.

Office JavaScript API: Controle ampliado

Office JavaScript API recebeu um número substancial de novos métodos em todo o conjunto.

Manipulação aprimorada de formulários

Trabalhar com formulários programaticamente agora é mais poderoso. Introduzimos novos métodos para lidar com elementos de formulário com precisão.

Métodos CheckBoxForm. Agora você pode gerenciar dinamicamente rótulos para caixas de seleção tanto na API de formulários quanto na API de documentos de texto:

• ApiCheckBoxForm/GetLabel
• ApiCheckBoxForm/SetLabel

Gerenciamento do ciclo de vida e de identidades. Padronizamos a forma como você interage com objetos de formulário. Novos métodos Delete e GetInternalId foram adicionados para praticamente todos os tipos de formulário, tanto na API de formulários quanto na API de documentos de texto. Isso inclui:

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

Esse controle granular permite um código mais limpo ao gerenciar formulários dinâmicos, permitindo que você remova elementos ou faça referência a eles por IDs internas programaticamente.

Métodos de parágrafo para APIs de apresentação e planilha

Uma das maiores novidades desta atualização é a expansão do método ApiParagraph às APIs de apresentação e planilha. Anteriormente, a manipulação profunda de parágrafos era principalmente o domínio da API de documento de texto. Agora, você pode aplicar formatação de rich text e alterações estruturais diretamente em slides e planilhas.

• Estrutura: InsertParagraph, Push, Last, GetLastRunWithText.
• Formatação: SetBold, SetItalic, SetUnderline, SetStrikeout, SetDoubleStrikeout, SetCaps, SetSmallCaps.
• Estilo: SetColor, SetFontSize, SetFontFamily, SetSpacing.
• Propriedades: GetFontNames, SetTextPr.
• Dados: ToJSON, GetInternalId.

Isso unifica a experiência do desenvolvedor em todos os editores, tornando seu código mais reutilizável, seja ao gerar um relatório em um documento ou formatar uma caixa de texto em uma apresentação de slides.

Ajudantes de conversão de unidades

O manuseio de medições no Office Open XML geralmente requer a conversão entre Unidades Métricas Inglesas (EMUs) e unidades padrão. Adicionamos métodos auxiliares às APIs de Apresentação, Planilha e Documento de Texto para simplificar isso:

• Api/EmusToMillimeters
• Api/MillimetersToEmus

Navegação e acesso ao conteúdo

Para a API de documentos de texto, melhoramos o movimento do cursor e a inserção de conteúdo, o que é crucial para macros que automatizam a digitação ou a edição:

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

Além disso, o acesso ao conteúdo de apresentações e planilhas ficou mais fácil com o novo ApiDocumentContent métodos como GetAllParagraphs, GetCurrentParagraph, e GetText.

Confira a lista completa dos novos métodos

Plug-ins para o Docs: melhor experiência de desenvolvimento

Criar plug-ins envolve mais do que apenas o código; envolve a experiência do desenvolvedor e a interface final do usuário.

Tutoriais de depuração

Adicionamos uma nova subseção sobre depuração aos nossos tutoriais para web e desktop editors. Esses guias ajudarão você a solucionar problemas em seus plug-ins de maneira mais rápida e eficaz.

Consistência da interface do usuário

• Ícones: Atualizamos o plugin Icons page com as melhores práticas. Adicionar ícones é um pequeno passo que melhora significativamente a usabilidade e torna sua interface intuitiva.
• Tema: Um novo “Como personalizar temas” a página explica como seu plugin pode detectar o tema atual do editor e reagir de acordo. Isso garante que seu plugin tenha uma aparência nativa, independentemente de o usuário estar no modo escuro ou claro.

Solução de problemas de localização

Adicionamos um Troubleshooting seção da página Localização para ajudá-lo a resolver problemas comuns ao traduzir seus plug-ins para um público global.

Atualizações do DocSpace SDK

Para desenvolvedores que integram nossa plataforma de colaboração baseada em salas DocSpace, o JavaScript SDK foi atualizado. A estrutura da documentação foi refatorada e agora é gerada automaticamente usando arquivos diretamente do DocSpace, garantindo que a referência que você lê esteja sempre em sincronia com o código real.

Melhorias no site de documentação da API

Estamos constantemente melhorando o documentação da API para torná-lo mais rápido e fácil de usar.

• Motor: Atualizamos o Docusaurus para a versão 3.9.2.
• Modo de tema do sistema: O site de documentação agora suporta a detecção do tema do sistema, respeitando a sua preferência do sistema operacional para o modo escuro ou claro.
• Usabilidade e localização: Redesenhamos a página inicial da documentação e melhoramos a documentação em chinês, incluindo a seção Desktop Editors totalmente traduzida.