Quickstart
이 가이드는 TypeScript용 Aspose.Cells FOSS 핵심 워크플로우를 단계별로 안내합니다: 처음부터 워크북을 만들고, 기존 XLSX 파일을 로드하고, 셀에 스타일을 적용하며, 데이터를 다른 형식으로 내보내는 과정입니다. 아래 각 섹션은 라이브러리를 소스에서 빌드한 후 Node.js 프로젝트에 복사해 사용할 수 있는 독립적인 예제입니다.
워크북 만들기
새 Workbook를 만들고, worksheet.putValue()을 사용하여 셀에 형식화된 값(문자열 및 숫자)을 기록한 다음, 결과를 XLSX 파일로 저장합니다:
import { Workbook } from "excel-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);
await workbook.save("report.xlsx");기존 워크북 로드
기존 XLSX 파일을 Workbook.load()로 열고, 그 다음 worksheet.getCell()을 사용해 셀 값을 다시 읽어옵니다. 이는 다른 도구에서 생성된 스프레드시트 데이터를 읽는 일반적인 진입점입니다:
import { Workbook } from "excel-cells";
const workbook = await Workbook.load("report.xlsx");
const worksheet = workbook.worksheets[0]!;
const product = worksheet.getCell(0, 0)?.value;
const revenue = worksheet.getCell(0, 1)?.value;
console.log(`${product}: ${revenue}`);스타일 적용
새 Style 객체를 생성하고, cell.setStyle()을 사용해 셀에 할당하기 전에 글꼴 설정(이름, 크기, 굵게, 색상)을 적용합니다. 스타일은 독립된 객체이므로 동일한 Style 인스턴스를 여러 셀에 재사용할 수 있습니다:
import { Workbook, Style } from "excel-cells";
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");여러 형식으로 내보내기
다른 파일 확장자를 사용하여 workbook.save()를 호출하면 동일한 데이터를 CSV, JSON, Markdown, 또는 HTML으로 내보낼 수 있습니다 – 별도의 변환 단계가 필요하지 않습니다:
import { Workbook } from "excel-cells";
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.xlsx");
await workbook.save("data.csv");
await workbook.save("data.json");
await workbook.save("data.md");