מבוא
Aspose.Cells FOSS for TypeScript היא ספרייה חינמית וקוד פתוח המאפשרת למפתחים ליצור, לקרוא, לשנות ולייצא גיליונות Excel ישירות מיישומי TypeScript. הספרייה מורשית ברישיון MIT ואין לה תלות ב‑Microsoft Office או בכל זמן ריצה מקורי — היא פועלת באופן זהה ב‑Windows, Linux וב‑macOS.
הספרייה מספקת API נקייה המבוססת על המחלקות Workbook, Worksheet, Cell ו-Style. מפתחים יכולים לכתוב ערכי תאים, להגדיר נוסחאות, להחיל עיצוב גופן ומילוי, להוסיף תרשימים וצורות, להגדיר אימות נתונים ומסננים אוטומטיים, ולייצא למגוון פורמטים כולל XLSX, CSV, JSON, Markdown ו-HTML.
התקן באמצעות פקודה אחת והתחל לבנות צינורות אוטומציה של גיליונות אלקטרוניים, יוצרי דוחות, וכלי ייצוא נתונים ללא תלות ב‑Office.
תכונות מרכזיות
קריאה וכתיבה של קבצי XLSX
טען חוברות עבודה קיימות עם Workbook.load() ושמור עם workbook.save(). ערכי תאים, נוסחאות וסגנונות עוברים הלוך ושוב דרך XLSX ללא אובדן. המחלקה WorksheetCollection תומכת ביצירה, הסרה וסידור מחדש של גיליונות עבודה.
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");
ערכי תאים ונוסחאות
כתוב שלמים, עשרוניים ומחרוזות עם worksheet.putValue(). הגדר נוסחאות עם cell.setFormula() – מחרוזת הנוסחה נשמרת במדויק בקובץ XLSX ומוערכת על‑ידי Excel או LibreOffice בעת הפתיחה.
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");
עיצוב גופן ומילוי
החל עיצוב מודגש, נטוי, גודל גופן, שם גופן וצבע גופן באמצעות המחלקה Style. לכל תא ניתן להחיל סגנון עצמאי משלו דרך 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");
ייצוא מרובה פורמטים
ייצא חוברות עבודה ל‑CSV, JSON, Markdown ו‑HTML באמצעות שיטות ייעודיות ב‑Workbook: toCsv(), toJson(), toMarkdown() ו‑toHtml(). לחלופין, העבר נתיב קובץ עם הסיומת הרצויה ל‑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");
התחלה מהירה
התקן את החבילה עם npm:
npm install @aspose/cells@1.0.0
צור חוברת עבודה, כתוב נתונים, החל עיצוב ושמור:
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");
פורמטים נתמכים
| פורמט | הרחבה | קריאה | כתיבה |
|---|---|---|---|
| XLSX | .xlsx | ✓ | ✓ |
| CSV | .csv | — | ✓ |
| JSON | .json | — | ✓ |
| Markdown | .md | — | ✓ |
| HTML | .html | ✓ | ✓ |
קוד פתוח ורישוי
Aspose.Cells FOSS for TypeScript משוחרר תחת רישיון MIT. קוד המקור מתארח ב-GitHub ומקבל דיווחי באגים ובקשות משיכה. שימוש מסחרי מותר בהתאם לתנאי רישיון MIT.