کار با مدیریت صفحه‌گسترده

مدیریت برگه‌های کاری

کلاس WorksheetCollection متدهایی برای مدیریت برگه‌های کاری درون یک کتاب کار فراهم می‌کند. برگه‌های جدید را با addWorksheet() اضافه کنید، با removeWorksheet() حذف کنید و با moveWorksheet() ترتیب آن‌ها را تغییر دهید.

import { Workbook } from "excel-cells";

const workbook = new Workbook();
const sheets = workbook.worksheets;

const sheet2 = sheets.addWorksheet("Sales");
const sheet3 = sheets.addWorksheet("Summary");

sheet2.putValue("A1", "Sales Data");
sheet3.putValue("A1", "Summary Report");

await workbook.save("multi-sheet.xlsx");

مقادیر و فرمول‌های سلول

اعداد صحیح، اعشار و رشته‌ها را با worksheet.putValue() بنویسید. سلول‌ها را با ارجاع با getCell2() یا با شاخص ردیف/ستون با getCell() دسترسی پیدا کنید. فرمول‌ها را با cell.setFormula() تنظیم کنید.

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("values.xlsx");

استایل‌گذاری فونت و پرشدن

تنظیمات فونت را با استفاده از کلاس Style اعمال کنید. نام فونت، اندازه، ضخیم، ایتالیک و رنگ را تنظیم کنید. سبک را به سلول‌های منفرد با cell.setStyle() اعمال کنید.

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.setItalic(true);
style.setFontColor("FF0000");

const cell = worksheet.getCell2("A1");
cell.putValue("Styled Text");
cell.setStyle(style);

await workbook.save("styled.xlsx");

اعتبارسنجی داده‌ها

قواعد اعتبارسنجی را به بازه‌های سلولی با استفاده از DataValidation اضافه کنید. نوع اعتبارسنجی (لیست، بازه عددی یا سفارشی) را مشخص کنید و با worksheet.addDataValidation() اعمال کنید.

import { Workbook, DataValidation } from "excel-cells";

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() فعال کنید. فیلترها را با 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.setAutoFilter("A1:C4");
await workbook.save("filtered.xlsx");

Hyperlinks

هایپرلینک‌ها را به سلول‌ها با cell.setHyperlink() الصاق کنید. URLها، آدرس‌های ایمیل و ارجاعات داخلی به شیت را پشتیبانی می‌کند.

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) قفل کنید.

import { Workbook, Style } from "excel-cells";

const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;

worksheet.putValue("A1", "Protected Cell");
const style = new Style();
style.setLocked(true);
worksheet.getCell2("A1").setStyle(style);

workbook.protect(true, "password");
await workbook.save("protected.xlsx");

تغییر اندازه ستون و ردیف

عرض ستون‌ها و ارتفاع ردیف‌ها را تنظیم کنید تا ابعاد سلول‌ها در فایل خروجی 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");

همچنین ببینید:

 فارسی