Introducción
Aspose.Cells FOSS para TypeScript es una biblioteca gratuita y de código abierto que permite a los desarrolladores crear, leer, modificar y exportar hojas de cálculo de Excel directamente desde aplicaciones TypeScript. La biblioteca tiene licencia MIT y no depende de Microsoft Office ni de ningún tiempo de ejecución nativo; se ejecuta idénticamente en Windows, Linux y macOS.
La biblioteca proporciona una API limpia construida alrededor de Workbook, Worksheet, Cell y Style. Los desarrolladores pueden escribir valores de celdas, establecer fórmulas, aplicar estilo de fuente y relleno, agregar gráficos y formas, configurar validación de datos y autofiltros, y exportar a varios formatos, incluidos XLSX, CSV, JSON, Markdown y HTML.
Instala con un solo comando y comienza a crear pipelines de automatización de hojas de cálculo, generadores de informes y herramientas de exportación de datos sin ninguna dependencia de Office.
Características clave
Leer y escribir archivos XLSX
Cargue libros de trabajo existentes con Workbook.load() y guarde con workbook.save(). Los valores de celda, fórmulas y estilos realizan un viaje de ida y vuelta a través de XLSX sin pérdida. La clase WorksheetCollection admite crear, eliminar y reordenar hojas de cálculo.
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 celdas y fórmulas
Escriba enteros, decimales y cadenas con worksheet.putValue(). Establezca fórmulas con cell.setFormula() – la cadena de la fórmula se almacena literalmente en el archivo XLSX y se evalúa por Excel o LibreOffice al abrirlo.
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");
Estilizado de Fuente y Relleno
Aplicar negrita, cursiva, tamaño de fuente, nombre de fuente y color de fuente usando la clase Style. Cada celda puede tener su propio estilo independiente aplicado a través de 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");
Exportación multiformato
Exporte libros de trabajo a CSV, JSON, Markdown y HTML utilizando los métodos dedicados en Workbook: toCsv(), toJson(), toMarkdown() y toHtml(). Alternativamente, pase una ruta de archivo con la extensión deseada a 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");
Inicio rápido
Instala el paquete con npm:
npm install @aspose/cells@1.0.0
Crea un libro de trabajo, escribe datos, aplica estilo y guarda:
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 compatibles
| Formato | Extensión | Leer | Escribir |
|---|---|---|---|
| XLSX | .xlsx | ✓ | ✓ |
| CSV | .csv | — | ✓ |
| JSON | .json | — | ✓ |
| Markdown | .md | — | ✓ |
| HTML | .html | ✓ | ✓ |
Código abierto y licencias
Aspose.Cells FOSS para TypeScript se publica bajo la licencia MIT. El código fuente está alojado en GitHub y acepta informes de errores y solicitudes de extracción. El uso comercial está permitido bajo los términos de la licencia MIT.
