Resumo da API: últimas atualizações para o ONLYOFFICE Docs

1 maio 2025Por Klaibson

Lançamos uma série de atualizações de API para o ONLYOFFICE Docs, com o objetivo de aprimorar a compatibilidade, a personalização e a segurança. Seja para criar fluxos de trabalho personalizados, possibilitar a colaboração segura de documentos ou integrar com APIs avançadas, essas melhorias oferecem possibilidades ilimitadas. Veja aqui um resumo das últimas adições e melhorias.

Resumo da API: últimas atualizações para o ONLYOFFICE Docs

Suporte a formatos de arquivo estendidos

A API Docs agora oferece suporte a formatos de arquivo adicionais, oferecendo compatibilidade mais ampla, garantindo uma experiência fluida para usuários que trabalham com diversos tipos de arquivo. Entre eles estão os formatos Apple iWork e Hancom Office:

  • pages
  • key
  • numbers
  • hwp
  • hwpx

Esses formatos podem ser especificados usando a propriedade documentType , por exemplo:

const config = {
  documentType: "pages",

Opções de personalização aprimoradas

Os desenvolvedores agora têm mais controle sobre o comportamento e a aparência do editor. As principais atualizações incluem:

  • Dicas de recursos para ocultar

O parâmetro editorConfig.customization.features.featuresTips permite habilitar ou desabilitar dicas de ferramentas sobre os novos recursos durante o primeiro carregamento do editor após a atualização. O valor padrão é true.

  • Exibição de barras de rolagem da planilha

A partir da versão 8.3, é possível definir se a rolagem horizontal/vertical será exibida ou ocultada automaticamente quando o editor de planilhas for carregado. Verifique editorConfig.customization.showHorizontalScroll e editorConfig.customization.showVerticalScroll para controlar esses parâmetros.

  • Plano de fundo da apresentação de slides

Use o editorConfig.customization.slidePlayerBackground parâmetro para definir a cor de fundo do slideshow nos formatos HEX, RGB, ou RGBA. Por exemplo, #ff0000, rgb(255, 0, 0), rgba(255, 0, 0, 0.5).

showHorizontalScroll: true,
      showVerticalScroll: true,
      slidePlayerBackground: "#000000",
  • Cores de cabeçalho do documento

Personalize os estilos de título no editor de documentos com o parâmetro editorConfig.customization.wordHeadingsColor, permitindo especificações de cores HEX.

  • Botão de informações do celular

Alterne a exibição do botão Informações do documento para editores móveis usando editorConfig.customization.mobile.info. O valor padrão é false.

  • Modo ponteiro

Ajuste o modo do ponteiro (selecionar ou mão) no visualizador de apresentação usando o parâmetro editorConfig.customization.pointerMode . O valor padrão é select.

Resumo da API: últimas atualizações para o ONLYOFFICE Docs

  • Barra de ferramentas compacta para o visualizador

O parâmetro editorConfig.customization.compactToolbar agora suporta o modo de visualização, permitindo alternar entre barras de ferramentas completas e compactas. O valor padrão para o modo de visualização é true.

Recursos de segurança aprimorados

A API Docs introduz o tratamento de arquivos protegidos por senha com a adição events.onUserActionRequired do evento. A função é chamada quando uma ação do usuário é necessária para abrir um documento nos seguintes casos:

  • quando o usuário precisa digitar uma senha para abrir o documento protegido;
  • quando o usuário precisa selecionar uma codificação para o arquivo TXT;
  • quando o usuário precisa selecionar uma codificação e um delimitador para o arquivo CSV.

Aqui está um exemplo de como o evento funciona:

function onUserActionRequired() {
  console.log("Enter a password")
};
const config = {
  events: {
    onUserActionRequired,
  },
};
const docEditor = new DocsAPI.DocEditor("placeholder", config);

O que mais, agora você pode usar o comando drop para proibir a edição de documentos para usuários específicos:

{
  "c": "drop",
  "key": "Khirz6zTPdfd7",
  "users": ["6d5a81d0"]
}

O changelog completo da API Docs está disponível aqui.

Obtenha a versão mais recente do ONLYOFFICE Docs Developer:

BAIXE AGORA

Novos métodos da API do Office

A Api do Office recebe atualizações significativas para melhor gestão documental, nomeadamente:

  • Marcadores
  • Controles de Conteúdo
  • Seções
  • Autofiltros
  • Seleção
  • E mais

Essas melhorias permitem interações e experiências de edição mais ricas. Para uma análise detalhada dos comandos, consulte o Log de alterações da API do Office.

Atualizações da API de plugins

Vários novos métodos e propriedades expandem as capacidades dos plugins:

  • Recuperação de conteúdo

O método GetSelectedContent recupera conteúdo selecionado em um formato especificado.

expression.GetSelectedContent(prop);

  • Mensagens de erro

O método ShowError permite que os plugins exibam mensagens de erro ou aviso.

expression.ShowError(error, level);

  • Propriedades de controle de conteúdo aprimoradas

Novas propriedades Shd (sombreamento de fundo) e Border melhorar o objeto ContentControlProperties para melhor personalização visual.

  • Ativação do painel

O parâmetro isActivated permite que você especifique se um painel de plugin criado será expandido (true) ou entrou em colapso (false) em carga.

Veja a lista completa das atualizações da API do plugin.

Crie sua conta gratuita no ONLYOFFICE

Visualize, edite e colabore em documentos, planilhas, slides, formulários e arquivos PDF online.