Introdução
Aspose.Cells FOSS for TypeScript fornece um conjunto abrangente de recursos de gerenciamento de planilhas além da leitura/gravação básica de células. Os desenvolvedores podem aplicar estilos detalhados, definir regras de validação de dados, configurar auto-filtros, adicionar formatação condicional, criar gráficos, inserir formas e proteger pastas de trabalho – tudo a partir de código TypeScript sem dependência do Microsoft Office.
Este post apresenta as principais funcionalidades de gerenciamento de planilhas disponíveis na biblioteca, com exemplos de código funcionais para cada área de recurso.
Recursos Principais
Validação de Dados
Adicione regras de validação a intervalos de células usando a classe DataValidation. Os tipos de validação suportados incluem lista, intervalo numérico e fórmulas personalizadas. Aplique validação a qualquer intervalo com worksheet.addDataValidation().
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
const validation = new DataValidation();
validation.type = "list";
validation.formula1 = '"Option1,Option2,Option3"';
worksheet.addDataValidation(validation, "B1:B10");
await workbook.save("validated.xlsx");
Filtro automático
Habilite cabeçalhos de auto‑filtro em um intervalo de dados com worksheet.setAutoFilter(). Isso adiciona controles de filtro suspensos aos cabeçalhos de coluna no arquivo XLSX de saída. Remova os filtros com worksheet.removeAutoFilter().
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");
Formatação Condicional
Aplique regras visuais a intervalos de células usando ConditionalFormatCollection. A biblioteca suporta ColorScaleRule, DataBarRule e IconSetRule para realçar células com base em seus valores.
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
for (let i = 1; i <= 10; i++) {
worksheet.putValue(`A${i}`, i * 10);
}
await workbook.save("conditional.xlsx");
Hyperlinks e Comentários
Anexe hyperlinks às células com cell.setHyperlink() suportando URLs, endereços de e‑mail e referências internas de planilha. Adicione comentários com worksheet.addComment() usando objetos Comment.
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Click here");
worksheet.getCell2("A1").setHyperlink("https://www.example.com");
worksheet.putValue("A3", "Send email");
worksheet.getCell2("A3").setHyperlink("mailto:test@example.com");
await workbook.save("hyperlinks.xlsx");
Proteção de Pasta de Trabalho e Células
Proteja planilhas inteiras com uma senha usando workbook.protect(). Bloqueie células individuais com style.setLocked(true) e controle a visibilidade de fórmulas com style.setHidden().
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Protected Cell");
const style = new Style();
style.setLocked(true);
style.setHidden(false);
worksheet.getCell2("A1").setStyle(style);
workbook.protect(true, "password");
await workbook.save("protected.xlsx");
Dimensionamento de Colunas e Linhas
Defina larguras de coluna com worksheet.setColumnWidth() e alturas de linha com worksheet.setRowHeight(). Oculte linhas com worksheet.setRowHidden(). Essas configurações permanecem no arquivo XLSX salvo.
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Wide Column");
worksheet.setColumnWidth(0, 30);
worksheet.setRowHeight(0, 25);
await workbook.save("sized.xlsx");
Início Rápido
Instale com npm:
npm install @aspose/cells@1.0.0
Crie uma pasta de trabalho estilizada com validação e filtro automático:
import { Workbook, Style, DataValidation } from "@aspose/cells";
const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Status");
worksheet.putValue("B1", "Value");
const headerStyle = new Style();
headerStyle.setBold(true);
worksheet.getCell2("A1").setStyle(headerStyle);
worksheet.getCell2("B1").setStyle(headerStyle);
const validation = new DataValidation();
validation.type = "list";
validation.formula1 = '"Active,Inactive,Pending"';
worksheet.addDataValidation(validation, "A2:A20");
worksheet.setAutoFilter("A1:B20");
await workbook.save("managed.xlsx");
Código Aberto e Licenciamento
Aspose.Cells FOSS for TypeScript é lançado sob a licença MIT. O código‑fonte está disponível no GitHub. O uso comercial é permitido sob os termos da licença MIT.
