Como adicionar estilos de tabela consistentes com uma macro ONLYOFFICE

Embora tenhamos abordado uma parte significativa das macros para gerenciar tabelas de planilhas, ainda há situações em que talvez seja necessário trabalhar com tabelas no Editor de documentos. Com essa macro, os usuários podem definir regras de formatação específicas, como estilos de fonte, bordas de células, cores de fundo e alinhamento, que podem ser aplicadas a todas as tabelas do documento. Vamos criar essa macro simples e ver como ela funciona em ação.

Criação da macro

  const oDocument = Api.GetDocument();
  const allTables = oDocument.GetAllTables();

Para começar, obtemos a planilha ativa na variável oDocument. Em seguida, usamos o método GetAllTables() para recuperar todas as tabelas do documento.

  allTables.ForEach(function (table) {
    const oTable = table;

Em seguida, iteramos pela matriz allTables usando um loop ForEach, com o objetivo de executar operações em uma tabela de cada vez.

    //modifyable part
    oTable.SetWidth("percent", 100);
    oTable.SetTableBorderTop("single", 32, 0, 51, 51, 51);
    oTable.SetTableBorderBottom("single", 4, 0, 51, 51, 51);
    oTable.SetTableBorderLeft("single", 4, 0, 51, 51, 51);
    oTable.SetTableBorderRight("single", 4, 0, 51, 51, 51);
    oTable.SetTableBorderInsideV("single", 4, 0, 255, 111, 61);
    oTable.SetTableBorderInsideH("single", 4, 0, 255, 111, 61);

Esse é o núcleo do loop ForEach, onde são definidas as regras de formatação das tabelas. Essas regras serão aplicadas de forma consistente a todas as tabelas do documento. Incluímos alguns métodos para que você tenha uma compreensão mais clara de como a macro funciona. Para se aprofundar em todas as opções e métodos de formatação, consulte a seção Documentação da API do ONLYOFFICE para o objeto Tabela.

Este é um exemplo de como uma tabela será exibida após a aplicação da macro com os estilos existentes definidos no loop ForEach.

Observação: os métodos dentro do loop ForEach são apenas para referência e podem ser alterados de acordo com seu caso de uso.

Código completo da macro

Aqui está o código completo da macro:

(function () {
  //get the active sheets and comments
  const oDocument = Api.GetDocument();
  const allTables = oDocument.GetAllTables();

  allTables.ForEach(function (table) {
    const oTable = table;

    //modifyable part
    oTable.SetWidth("percent", 100);
    oTable.SetTableBorderTop("single", 32, 0, 51, 51, 51);
    oTable.SetTableBorderBottom("single", 4, 0, 51, 51, 51);
    oTable.SetTableBorderLeft("single", 4, 0, 51, 51, 51);
    oTable.SetTableBorderRight("single", 4, 0, 51, 51, 51);
    oTable.SetTableBorderInsideV("single", 4, 0, 255, 111, 61);
    oTable.SetTableBorderInsideH("single", 4, 0, 255, 111, 61);
  });
})();

Agora, vamos ver nossa macro em ação.

Era isso. Uma macro simples, sem ciência de foguetes, que o ajuda a aplicar estilos a todas as suas tabelas. A API do ONLYOFFICE é uma ferramenta poderosa, capaz de executar uma ampla gama de tarefas e fornecer um imenso potencial para o desenvolvimento de macros e plug-ins ainda mais avançados. Com essa API, os usuários podem aproveitar todo o poder do ONLYOFFICE para aumentar sua produtividade e simplificar seus fluxos de trabalho.

Se tiver alguma dúvida ou conceito inovador, recomendamos que você compartilhe conosco. Valorizamos sua opinião e esperamos poder colaborar com você. Boa sorte em seus esforços exploratórios!