מבוא

Aspose.Cells FOSS for TypeScript מספקת סט מקיף של תכונות ניהול גיליונות אלקטרוניים מעבר לקריאה/כתיבה בסיסית של תאים. מפתחים יכולים להחיל עיצוב מפורט, להגדיר כללי אימות נתונים, להגדיר מסננים אוטומטיים, להוסיף עיצוב מותנה, לבנות תרשימים, להכניס צורות, ולהגן על חוברות עבודה – כל זאת מקוד TypeScript ללא תלות ב-Microsoft Office.

פוסט זה מסביר את היכולות המרכזיות לניהול גיליונות אלקטרוניים הזמינות בספרייה, עם דוגמאות קוד עובדות לכל תחום תכונה.

תכונות מרכזיות

אימות נתונים

הוסף כללי אימות לטווחי תאים באמצעות המחלקה DataValidation. סוגי האימות הנתמכים כוללים רשימה, טווח מספרים ונוסחאות מותאמות. החל אימות על כל טווח באמצעות 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");

סינון אוטומטי

הפעל כותרות סינון אוטומטי בטווח נתונים עם worksheet.setAutoFilter(). פעולה זו מוסיפה בקרים של סינון נפתחים לכותרות העמודות בקובץ XLSX המפלט. הסר סינונים עם 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");

עיצוב מותנה

החל כללי חזות על טווחי תאים באמצעות ConditionalFormatCollection. הספרייה תומכת ב-ColorScaleRule, DataBarRule ו-IconSetRule לצביעת תאים בהתבסס על ערכיהם.

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");

קישורים והערות

הצמד קישורים היפר‑טקסט לתאים עם cell.setHyperlink() התומכים בכתובות URL, כתובות דוא"ל והפניות פנימיות לגיליון. הוסף הערות עם worksheet.addComment() באמצעות אובייקטים של 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");

הגנה על חוברת עבודה ותא

הגן על כל חוברות העבודה עם סיסמה באמצעות workbook.protect(). נעל תאים בודדים עם style.setLocked(true) ושלוט בנראות הנוסחה עם 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");

גודל עמודה ושורה

הגדר רוחבי עמודות עם worksheet.setColumnWidth() וגבהי שורות עם worksheet.setRowHeight(). הסתר שורות עם worksheet.setRowHidden(). הגדרות אלו נשמרות בקובץ XLSX השמור.

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");

התחלה מהירה

התקן עם npm:

npm install @aspose/cells@1.0.0

בנה חוברת עבודה מעוצבת עם אימות וסינון אוטומטי:

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");

קוד פתוח ורישוי

Aspose.Cells FOSS for TypeScript משוחרר תחת רישיון MIT. קוד המקור זמין ב-GitHub. שימוש מסחרי מותר בהתאם לתנאי רישיון MIT.

התחלה

משאבים קשורים