1. Produtos
  2.   Aspose.Cells
  3.   Aspose.Cells FOSS for TypeScript

Aspose.Cells FOSS para TypeScript

Crie, modifique e exporte planilhas Excel a partir do TypeScript – gratuito e de código aberto, sem dependência do Microsoft Office.

Aspose.Cells FOSS for TypeScript Aspose.Cells FOSS
for TypeScript

Documentação GitHub

Biblioteca TypeScript Open-Source para Planilhas Excel

Aspose.Cells FOSS for TypeScript é uma biblioteca gratuita e de código aberto para trabalhar com arquivos de planilha em aplicações TypeScript. Instale-a com npm install @aspose/cells@1.0.0 e comece a criar pastas de trabalho, ler células, aplicar estilos, criar gráficos e exportar para XLSX, CSV, Markdown, JSON ou HTML – tudo sem exigir Microsoft Excel ou qualquer dependência do Office.

A biblioteca expõe uma API limpa construída em torno de Workbook, Worksheet, Cell e Style – os objetos familiares que todo desenvolvedor de planilhas conhece. Leia e escreva células usando putValue(), estilize-as com Style, Font e Fill objetos, adicione gráficos via ChartCollection, e configure validação de dados, auto-filtros, comentários e hyperlinks em qualquer planilha.

Ler e Gravar Arquivos Excel

  • XLSX round-trip: Carregue pastas de trabalho com Workbook.load() e salve com workbook.save() preservando valores de células, fórmulas e estilos.
  • Acesso a células: Leia e escreva valores com worksheet.putValue() e worksheet.getCell() por índice de linha/coluna ou referência de célula.
  • Fórmulas: Escreva strings de fórmula via cell.setFormula() – armazenadas literalmente no XLSX, avaliadas pelo Excel ou LibreOffice ao abrir.
  • Múltiplas planilhas: Criar, renomear, mover e remover planilhas com métodos WorksheetCollection incluindo addWorksheet(), removeWorksheet() e moveWorksheet().

Onde Aspose.Cells FOSS pode ser usado

  • Data pipelines: Exportar resultados de consultas ao banco de dados diretamente para XLSX ou CSV usando workbook.toCsv().
  • Geração de relatórios: Crie relatórios Excel estilizados e com marca sem precisar do Office instalado.
  • Documentação: Converta planilhas para Markdown via workbook.toMarkdown().
  • ETL workflows: Leia planilhas de entrada, transforme os dados e escreva pastas de trabalho de saída.
  • Automação CI/CD: Gere planilhas de resultados de teste dentro de contêineres Docker.

Estilização, Gráficos e Formas

  • Fonte e preenchimento: Aplique negrito, itálico, tamanho da fonte e cores via Style com setBold(), setItalic(), setFontSize() e setFontColor().
  • Formatos de número: Defina formatos de data, moeda e número personalizados por célula usando numFmtId em Style.
  • Charts: Crie gráficos de barras, linhas, pizza, área e dispersão com ChartCollection e renderize os dados do gráfico via ChartRenderer.
  • Formas: Adicione formas vetoriais às planilhas com addShape(), suportando retângulos, elipses, setas, conectores e mais por meio da hierarquia ShapeInfo.

Exportação e Proteção

  • Exportação multi-formato: Salve em XLSX, CSV, JSON, Markdown e HTML usando workbook.save() ou métodos dedicados como toJson(), toCsv(), toMarkdown() e toHtml().
  • HTML importação e exportação: Carregar tabelas HTML com HtmlReader e exportar workbooks estilizados com HtmlExporter.
  • Proteção de pasta de trabalho: Proteja pastas de trabalho com uma senha usando workbook.protect(true, "password").
  • Proteção de célula: Bloqueie células individuais com style.setLocked(true) e controle a visibilidade de fórmulas com style.setHidden().

Validação de Dados e Filtragem

  • Validação de dados: Adicione regras de validação de lista, número e personalizadas a intervalos de células com DataValidation e worksheet.addDataValidation().
  • Auto-filter: Defina cabeçalhos de coluna filtráveis com worksheet.setAutoFilter() e remova filtros com removeAutoFilter().
  • Formatação condicional: Aplique escalas de cores, barras de dados e conjuntos de ícones via ConditionalFormatCollection com ColorScaleRule, DataBarRule e IconSetRule.
  • Comentários: Anexe comentários de célula com objetos Comment via worksheet.addComment().

Experiência do Desenvolvedor

Aspose.Cells FOSS para TypeScript pode ser instalado com um único comando npm install @aspose/cells@1.0.0. Não há bibliotecas nativas do Office ou pacotes de sistema para instalar. A biblioteca funciona em qualquer ambiente Node.js com suporte ao TypeScript 5+.

A API cobre Workbook, Worksheet, Cell, Style, Font, Fill, Chart, DataValidation, AutoFilter, Comment, Hyperlink e Shape – os objetos principais para automação de planilhas no mundo real. O código‑fonte está licenciado sob MIT, hospedado no GitHub e aceita relatórios de bugs e pull requests.

Escrever valores e fórmulas de células

Crie uma pasta de trabalho, escreva diferentes tipos de valores nas células e defina fórmulas que o Excel avalia ao abrir.

const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", 42);
worksheet.putValue("A2", 3.14159);
worksheet.putValue("A3", "Hello World");
const cellA4 = worksheet.getCell2("A4");
cellA4.setFormula("=SUM(A1:A2)");
await workbook.save("output.xlsx");

Aplicar formatação de fonte

Defina o nome da fonte, tamanho, negrito, itálico e cor em uma célula usando a classe Style.

const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
const style = new Style();
style.setFontName("Arial");
style.setFontSize(14);
style.setBold(true);
style.setItalic(true);
style.setFontColor("FF0000");
const cell = worksheet.getCell2("A1");
cell.putValue("Styled Text");
cell.setStyle(style);
await workbook.save("styled.xlsx");

Configurar filtro automático

Preencha um intervalo de dados e habilite os cabeçalhos de filtro automático para filtragem interativa de colunas no Excel.

const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Name");
worksheet.putValue("B1", "Age");
worksheet.putValue("C1", "City");
worksheet.putValue("A2", "Alice");
worksheet.putValue("B2", "25");
worksheet.putValue("C2", "New York");
worksheet.putValue("A3", "Bob");
worksheet.putValue("B3", "30");
worksheet.putValue("C3", "London");
worksheet.setAutoFilter("A1:C4");
await workbook.save("filtered.xlsx");

Perguntas Frequentes

O que é Aspose.Cells FOSS para TypeScript?

É uma biblioteca TypeScript gratuita, licenciada sob MIT, para criar, ler, modificar e exportar planilhas Excel sem exigir o Microsoft Office.

Quais formatos de arquivo são suportados?

.xlsx para leitura/gravação. Formatos somente de exportação incluem CSV, JSON, Markdown e HTML. HTML também pode ser importado via HtmlReader.

Ele requer Microsoft Excel ou Office?

Não. Aspose.Cells FOSS é uma biblioteca TypeScript pura sem dependência do Microsoft Office, automação COM ou qualquer runtime proprietário.

Como faço para instalá-lo?

Execute npm install @aspose/cells@1.0.0. Nenhum pacote de sistema adicional ou extensões nativas são necessários.

Posso aplicar formatação de célula?

Sim. Use a classe Style com métodos como setBold(), setItalic(), setFontSize(), setFontName() e setFontColor() para estilizar células individuais.

A proteção da pasta de trabalho é suportada?

Sim. Chame workbook.protect(true, "password") para proteger uma pasta de trabalho com uma senha. Células individuais podem ser bloqueadas com style.setLocked(true).

  

Recursos de Suporte e Aprendizado

 Português