Introdução
Aspose.Cells FOSS for TypeScript é uma biblioteca gratuita e de código aberto que permite aos desenvolvedores criar, ler, modificar e exportar planilhas Excel diretamente de aplicações TypeScript. A biblioteca tem licença MIT e não depende do Microsoft Office ou de qualquer runtime nativo — ela funciona de forma idêntica no Windows, Linux e macOS.
A biblioteca fornece uma API limpa construída em torno das classes Workbook, Worksheet, Cell e Style. Os desenvolvedores podem escrever valores de células, definir fórmulas, aplicar estilos de fonte e preenchimento, adicionar gráficos e formas, configurar validação de dados e filtros automáticos e exportar para vários formatos, incluindo XLSX, CSV, JSON, Markdown e HTML.
Instale com um único comando e comece a criar pipelines de automação de planilhas, geradores de relatórios e ferramentas de exportação de dados sem nenhuma dependência do Office.
Recursos Principais
Ler e gravar arquivos XLSX
Carregue pastas de trabalho existentes com Workbook.load() e salve com workbook.save(). Valores de células, fórmulas e estilos são mantidos ao percorrer o ciclo XLSX sem perda. A classe WorksheetCollection suporta criar, remover e reordenar planilhas.
const workbook = await Workbook.load("input.xlsx");
const worksheet = workbook.worksheets[0]!;
console.log("A1:", worksheet.getCell(0, 0)?.value);
worksheet.putValue("B1", "Updated");
await workbook.save("output.xlsx");
Valores de Célula e Fórmulas
Escreva inteiros, decimais e strings com worksheet.putValue(). Defina fórmulas com cell.setFormula() – a string da fórmula é armazenada literalmente no arquivo XLSX e avaliada pelo Excel ou LibreOffice ao ser aberto.
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("formulas.xlsx");
Estilização de Fonte e Preenchimento
Aplique negrito, itálico, tamanho da fonte, nome da fonte e cor da fonte usando a classe Style. Cada célula pode ter seu próprio estilo independente aplicado via cell.setStyle().
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
const style = new Style();
style.setFontName("Arial");
style.setFontSize(14);
style.setBold(true);
style.setFontColor("FF0000");
const cell = worksheet.getCell2("A1");
cell.putValue("Styled Text");
cell.setStyle(style);
await workbook.save("styled.xlsx");
Exportação Multi-Formato
Exporte workbooks para CSV, JSON, Markdown e HTML usando métodos dedicados em Workbook: toCsv(), toJson(), toMarkdown() e toHtml(). Alternativamente, passe um caminho de arquivo com a extensão desejada para workbook.save().
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Name");
worksheet.putValue("B1", "Age");
worksheet.putValue("A2", "Alice");
worksheet.putValue("B2", 25);
await workbook.save("data.csv");
await workbook.save("data.json");
await workbook.save("data.md");
Início Rápido
Instale o pacote com npm:
npm install @aspose/cells@1.0.0
Crie uma pasta de trabalho, escreva dados, aplique estilos e salve:
import { Workbook, Style } from "@aspose/cells";
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Product");
worksheet.putValue("B1", "Revenue");
worksheet.putValue("A2", "Widget");
worksheet.putValue("B2", 42000);
worksheet.putValue("A3", "Gadget");
worksheet.putValue("B3", 31500);
const headerStyle = new Style();
headerStyle.setBold(true);
headerStyle.setFontSize(12);
worksheet.getCell2("A1").setStyle(headerStyle);
worksheet.getCell2("B1").setStyle(headerStyle);
worksheet.setAutoFilter("A1:B3");
await workbook.save("report.xlsx");
Formatos suportados
| Formato | Extensão | Ler | Escrever |
|---|---|---|---|
| XLSX | .xlsx | ✓ | ✓ |
| CSV | .csv | — | ✓ |
| JSON | .json | — | ✓ |
| Markdown | .md | — | ✓ |
| HTML | .html | ✓ | ✓ |
Código Aberto e Licenciamento
Aspose.Cells FOSS para TypeScript é lançado sob a licença MIT. O código‑fonte está hospedado no GitHub e aceita relatórios de bugs e pull requests. O uso comercial é permitido sob os termos da licença MIT.
