परिचय
Aspose.Cells FOSS for TypeScript अपनी कार्यक्षमता को एक संक्षिप्त कोर क्लास सेट के माध्यम से उजागर करता है: Workbook, WorksheetCollection, Worksheet, Cell, और Style, साथ ही फ़ॉर्मेटिंग और फ़िल्टरिंग के लिए सहायक प्रकार। यह पोस्ट उस कोर API सतह की व्यवस्थित यात्रा है — न कि एक एकल संकीर्ण विषय, बल्कि वह मूलभूत बातें जो लाइब्रेरी पर निर्मित हर एप्लिकेशन उपयोग करती है: वर्कबुक खोलना और सहेजना, वर्कशीट्स को नेविगेट करना, सेल मान और फ़ॉर्मूले पढ़ना और लिखना, शैली लागू करना, डेटा फ़िल्टर करना, और अन्य फ़ॉर्मेट्स में निर्यात करना।
नीचे प्रत्येक अनुभाग API के एक क्षेत्र को कवर करता है, जिसमें शामिल ठोस मेथड्स और प्रॉपर्टीज़ हैं, और कार्यशील TypeScript उदाहरणों द्वारा समर्थित है। लक्ष्य यह है कि आप एक कार्यशील मानसिक मॉडल प्राप्त करें कि ये भाग कैसे साथ मिलते हैं, new Workbook() से लेकर व्यक्तिगत Cell प्रॉपर्टीज़ तक।
मुख्य विशेषताएँ
वर्कबुक और वर्कशीट मूलभूत बातें
एक Workbook या तो new Workbook() के साथ खाली बनाया जाता है या Workbook.load(filePath, password) के साथ मौजूदा फ़ाइल से असिंक्रोनस रूप से लोड किया जाता है। प्रत्येक वर्कबुक worksheets को उजागर करती है, एक WorksheetCollection जो अनुक्रमण, इटरशन, और एरे-स्टाइल मेथड्स (map, filter, forEach, find, indexOf) का समर्थन करता है, साथ ही addWorksheet(name), removeWorksheet(index), और moveWorksheet(fromIndex, toIndex) भी। बदलावों को स्थायी करने के लिए workbook.save(filePath, options) को कॉल करें।
const workbook = new Workbook();
const ws1 = workbook.worksheets.addWorksheet();
const ws2 = workbook.worksheets.addWorksheet("CustomSheet1");
console.log("Total worksheets:", workbook.worksheets.length);
workbook.worksheets.removeWorksheet(1);
console.log("After delete:", workbook.worksheets.length);
console.log(
"Names:",
workbook.worksheets.worksheets.map((w) => w.name),
);
await workbook.save("workbook.xlsx");
सेल एक्सेस और मान
एक Worksheet putValue(key, value) के माध्यम से कोशिकाओं को पढ़ता और लिखता है, getCell2(key) (एक Cell लौटाता है, यदि अनुपलब्ध हो तो उसे बनाता है), getCell(row, col) (लौटाता है Cell | undefined), और getCellByRef(ref)। प्रत्येक Cell value, formula, row, col, और ref को गुणों के रूप में उजागर करता है, तथा setFormula() / setStyle() / setHyperlink() को विधियों के रूप में।
const workbook = new Workbook();
const sheet = workbook.worksheets[0]!;
sheet.putValue("A1", 42);
sheet.putValue("A2", "Hello World");
const formulaCell = sheet.getCell2("A3");
formulaCell.setFormula("=A1+10");
console.log("A1 value:", sheet.getCell(0, 0)?.value);
console.log("A3 formula:", sheet.getCell(2, 0)?.formula);
const byRef = sheet.getCellByRef("A1");
console.log("Ref:", byRef?.ref, "Row:", byRef?.row, "Col:", byRef?.col);
await workbook.save("cells.xlsx");
स्टाइल, फ़ॉन्ट, बॉर्डर, और अलाइनमेंट
Style एक सेल के लिए फ़ॉन्ट, फ़िल, बॉर्डर, अलाइनमेंट, और नंबर-फ़ॉर्मेट सेटिंग्स को समूहित करता है। पूरे सब-ऑब्जेक्ट को getFont()/setFont(), getBorder()/setBorder(), और getAlignment()/setAlignment() के साथ पढ़ें या बदलें, या Style पर सीधे सुविधा सेटर्स का उपयोग करें, जैसे setFontName(), setFontSize(), setBold(), setHorizontalAlignment(), और setNumberFormat()। तैयार Style को Cell.setStyle() के साथ किसी सेल पर लागू करें।
const workbook = new Workbook();
const sheet = workbook.worksheets[0]!;
const style = new Style();
style.setFontName("Arial");
style.setFontSize(14);
style.setBold(true);
style.setNumberFormat("0.00");
style.getBorder().bottom = { style: "thin", color: "000000" };
style.setHorizontalAlignment("center");
style.setVerticalAlignment("center");
style.setWrapText(true);
const cell = sheet.getCell2("B2");
cell.putValue(1234.5);
cell.setStyle(style);
console.log("Bold:", style.isBold(), "Format:", style.getNumberFormat());
await workbook.save("styled.xlsx");
AutoFilter क्लास के साथ ऑटो-फ़िल्टरिंग
Worksheet.setAutoFilter(range) सामान्य मामले के लिए एक शॉर्टकट है, लेकिन अंतर्निहित AutoFilter क्लास को भी सीधे उपयोग किया जा सकता है: इसे एक रेंज के साथ बनाएं, फिर प्रत्येक कॉलम के लिए addFilterColumn(col, filters, blank) कॉल करें ताकि यह परिभाषित किया जा सके कि कौन से मान दृश्यमान रहेंगे, या फ़िल्टरिंग को वापस करने के लिए removeFilterColumn(col) / clear() का उपयोग करें।
const workbook = new Workbook();
const sheet = workbook.worksheets[0]!;
sheet.putValue("A1", "Name");
sheet.putValue("B1", "City");
sheet.putValue("A2", "Alice");
sheet.putValue("B2", "New York");
sheet.putValue("A3", "Bob");
sheet.putValue("B3", "London");
const filter = new AutoFilter("A1:B3");
filter.addFilterColumn(1, ["New York"], false);
console.log("Filter range:", filter.range);
console.log("Filter columns:", filter.columns.length);
await workbook.save("filtered.xlsx");
HTML, CSV, JSON, और मार्कडाउन में निर्यात
.xlsx से आगे, एक Workbook स्वयं को सीधे टेक्स्ट के रूप में toHtml(), toCsv(), toJson(), और toMarkdown() के साथ रेंडर कर सकता है, या उसे ऐसी फ़ाइल में सहेजा जा सकता है जिसका एक्सटेंशन SaveFormat enum के माध्यम से फॉर्मेट चुनता है (XLSX, CSV, JSON, MARKDOWN, HTML)।
const workbook = new Workbook();
const sheet = workbook.worksheets[0]!;
sheet.putValue("A1", "Name");
sheet.putValue("B1", "Age");
sheet.putValue("A2", "Alice");
sheet.putValue("B2", 25);
sheet.putValue("A3", "Bob");
sheet.putValue("B3", 30);
console.log("JSON:", workbook.toJson());
console.log("Markdown:\n", workbook.toMarkdown());
await workbook.save("report.csv");
await workbook.save("report.html");
त्वरित प्रारंभ
git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-TypeScript.git
cd Aspose.Cells-FOSS-for-TypeScript
npm install
npm run buildimport { Workbook, Style } from "excel-cells";
const workbook = new Workbook();
const sheet = workbook.worksheets.get(0)!;
sheet.name = "Summary";
sheet.putValue("A1", "Item");
sheet.putValue("B1", "Count");
sheet.putValue("A2", "Widgets");
sheet.putValue("B2", 12);
sheet.putValue("A3", "Gadgets");
sheet.putValue("B3", 7);
const totalCell = sheet.getCell2("B4");
totalCell.setFormula("=SUM(B2:B3)");
const numberStyle = new Style();
numberStyle.setNumberFormat("0");
sheet.getCell2("B2").setStyle(numberStyle);
sheet.getCell2("B3").setStyle(numberStyle);
sheet.getCell2("B4").setStyle(numberStyle);
const detail = workbook.worksheets.addWorksheet("Detail");
detail.putValue("A1", "Raw Data");
await workbook.save("summary.xlsx");
const reloaded = await Workbook.load("summary.xlsx");
console.log("Worksheets:", reloaded.worksheets.length);
console.log("B4 formula:", reloaded.worksheets.get(0)!.getCell(3, 1)?.formula);
समर्थित फ़ॉर्मेट्स
| फ़ॉर्मेट | एक्सटेंशन | पढ़ें | लिखें |
|---|---|---|---|
| XLSX | .xlsx | ✓ | ✓ |
| HTML | .html | ✓ | ✓ |
| CSV | .csv | — | ✓ |
| JSON | .json | — | ✓ |
| Markdown | .md | — | ✓ |
ओपन सोर्स & लाइसेंसिंग
Aspose.Cells FOSS for TypeScript MIT लाइसेंस के तहत जारी किया गया है। स्रोत कोड GitHub पर उपलब्ध है। व्यावसायिक उपयोग MIT लाइसेंस की शर्तों के तहत अनुमति है।