คู่มือผู้พัฒนา

Aspose.Cells FOSS for Python is a free, open-source library for programmatic spreadsheet processing. Whether you are building data pipelines, generating automated reports, exporting ML results to Excel, or converting workbooks to Markdown for documentation pipelines, Aspose.Cells FOSS provides a comprehensive API that covers every layer of spreadsheet manipulation without requiring Microsoft Office.

คุณสมบัติหลัก

การดำเนินการกับ Workbook และ Worksheet

สร้างเวิร์กบุ๊กใหม่ตั้งแต่เริ่มต้นหรือเปิดไฟล์ XLSX หรือ CSV ที่มีอยู่แล้ว. นำทาง Workbook → Worksheets → Cells → Cell โครงสร้างด้วย API ที่สะอาดและเป็นแบบ Pythonic. เพิ่ม, เปลี่ยนชื่อ, และลบแผ่นงานโดยใช้ workbook.add_worksheet(name) และ workbook.remove_worksheet(index_or_name). เข้าถึงเซลล์แต่ละเซลล์โดยใช้ที่อยู่ (ws.cells["A1"]), ตั้งค่าโดยตรง, และวนซ้ำผ่านช่วงที่มีข้อมูล.

การจัดรูปแบบและสไตล์ของเซลล์

ใช้การจัดรูปแบบแบบละเอียดกับเซลล์แต่ละเซลล์. ควบคุมฟอนต์, ขนาด, สี, ตัวหนา, ตัวเอียง, ขีดเส้นใต้, และขีดฆ่า ผ่าน Font class. ตั้งค่าการเติมพื้นหลังโดยใช้ cell.style.fill.set_solid_fill("FFRRGGBB"). สีจะถูกแสดงเป็นสตริงฐานสิบหก 8 ตัวอักษร AARRGGBB โดยไม่มี # คำนำหน้า (เช่น,., "FFFF0000" สำหรับสีแดงทึบ).

การสร้างและการแสดงผลแผนภูมิ

เพิ่มแผนภูมิคอลัมน์, เส้น, แถบ, และวงกลมลงในแผ่นงานโดยใช้เมธอดเฉพาะเช่น ws.charts.add_bar(top_row, left_col, bottom_row, right_col) และ ws.charts.add_line(...). ตั้งค่าชื่อแผนภูมิเป็นสตริง (chart.title = "My Chart"), กำหนดข้อมูลประเภทที่ระดับแผนภูมิ (chart.category_data = "A2:A6"), และเพิ่มซีรีส์ที่ตั้งชื่อ (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

การสนับสนุนสูตร

ป้อนสูตรที่เข้ากันได้กับ Excel โดยการตั้งค่า cell.formula = "=SUM(A1:A5)" หรือการสร้าง Cell(None, "=SUM(A1:A5)") และกำหนดให้กับคอลเลกชันเซลล์.

การส่งออกหลายรูปแบบ

ส่งออกเวิร์กบุ๊กเป็น XLSX, CSV, TSV, Markdown และ JSON โดยใช้คำสั่งเดียว workbook.save(path) การเรียกใช้. ใช้ SaveFormat ค่าคงที่สำหรับการควบคุมโดยเจาะจง: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. ใช้ MarkdownSaveOptions สำหรับการสร้างผลลัพธ์ Markdown อย่างละเอียด (การจัดแนว, ระดับหัวข้อ, ดัชนีแผ่นงาน). ใช้ MarkdownHandler.save_markdown_to_string(wb) สำหรับการสร้าง Markdown ในหน่วยความจำ.

หมายเหตุ: Aspose.Cells FOSS ส่งออกเป็น XLSX, CSV, TSV, Markdown, และ JSON. การส่งออก PDF, HTML, PNG, TIFF, DOCX, และ PPTX ไม่ได้เป็นส่วนหนึ่งของไลบรารี FOSS.

ระบบนิเวศของปลั๊กอิน

ตัวเลือกเสริม markitdown-aspose-cells-plugin แพคเกจรวมกับไลบรารี MarkItDown ของ Microsoft เพื่อเพิ่มการสนับสนุนการอ่าน XLSX. ติดตั้งโดยใช้ pip install markitdown-aspose-cells-plugin และใช้มันอย่างโปร่งใสผ่าน MarkItDown API.


เริ่มต้นใช้งาน

ติดตั้ง

pip install aspose-cells-foss

สวัสดี โลก

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Hello, Aspose.Cells FOSS!"
ws.cells["A2"].value = 42
workbook.save("hello.xlsx")

ส่งออกเป็น Markdown

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 95
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 88

workbook.save_as_markdown("results.md")

สร้างแผนภูมิคอลัมน์

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]

data = [("Q1", 50), ("Q2", 100), ("Q3", 170), ("Q4", 300)]
for i, (label, value) in enumerate(data):
    ws.cells[f"A{i+2}"].value = label
    ws.cells[f"B{i+2}"].value = value

chart = ws.charts.add_bar(6, 0, 20, 8)
chart.title = "Quarterly Revenue"
chart.category_data = "A2:A5"
chart.n_series.add("B2:B5", category_data="A2:A5", name="Revenue")

workbook.save("chart.xlsx")

จัดรูปแบบเซลล์

from aspose.cells_foss import Workbook, Cell, Font

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"] = Cell("Revenue Report")

cell = ws.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FFFFFFFF"   # White text (AARRGGBB, no #)
cell.style.fill.set_solid_fill("FF1E64C8")  # Blue background

workbook.save("styled.xlsx")

คู่มือที่พร้อมใช้งาน


ดูเพิ่มเติม

 ภาษาไทย