מבוא
Aspose.Cells FOSS עבור TypeScript היא ספרייה חינמית וקוד פתוח המאפשרת למפתחים ליצור, לקרוא, לשנות ולייצא גליונות Excel ישירות מיישומי TypeScript. הספרייה מורשית ברישיון MIT ואין לה תלות ב-Microsoft Office או בכל runtime מקורי – היא פועלת באופן זהה ב-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");
התחלה מהירה
בנה את החבילה ממקור:
git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-TypeScript.git
cd Aspose.Cells-FOSS-for-TypeScript
npm install
npm run buildצור חוברת עבודה, כתוב נתונים, החל עיצוב ושמור:
import { Workbook, Style } 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);
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 עבור TypeScript שוחרר ברישיון MIT. קוד המקור מתארח ב-GitHub ומקבל דוחות באגים ובקשות משיכה. שימוש מסחרי מותר בהתאם לתנאי רישיון MIT.