Hướng Dẫn Nhà Phát Triển

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.

Các tính năng chính

Các thao tác Workbook và Worksheet

Tạo sổ làm việc mới từ đầu hoặc mở các tệp XLSX hoặc CSV hiện có. Duyệt qua Workbook → Worksheets → Cells → Cell cây phân cấp với API sạch sẽ, mang phong cách Python. Thêm, đổi tên và xóa các trang tính bằng cách sử dụng workbook.add_worksheet(name) và workbook.remove_worksheet(index_or_name). Truy cập các ô riêng lẻ bằng địa chỉ (ws.cells["A1"]), đặt giá trị trực tiếp và lặp lại các phạm vi đã được điền dữ liệu.

Định dạng và kiểu dáng ô

Áp dụng định dạng chi tiết cho từng ô. Kiểm soát họ phông chữ, kích thước, màu sắc, in đậm, in nghiêng, gạch dưới và gạch ngang thông qua Font lớp. Đặt màu nền bằng cách sử dụng cell.style.fill.set_solid_fill("FFRRGGBB"). Màu sắc được biểu diễn dưới dạng chuỗi hex 8 ký tự AARRGGBB mà không có # tiền tố (ví dụ,., "FFFF0000" đối với màu đỏ đậm).

Tạo biểu đồ và trực quan hoá

Thêm các biểu đồ cột, đường, thanh và tròn vào trang tính bằng các phương thức chuyên dụng như ws.charts.add_bar(top_row, left_col, bottom_row, right_col) và ws.charts.add_line(...). Đặt tiêu đề biểu đồ dưới dạng chuỗi (chart.title = "My Chart"), cấu hình dữ liệu danh mục ở mức biểu đồ (chart.category_data = "A2:A6"), và thêm chuỗi có tên (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

Hỗ trợ công thức

Nhập công thức tương thích với Excel bằng cách đặt cell.formula = "=SUM(A1:A5)" hoặc xây dựng một Cell(None, "=SUM(A1:A5)") và gán nó vào bộ sưu tập các ô.

Xuất đa định dạng

Xuất sổ làm việc sang XLSX, CSV, TSV, Markdown và JSON bằng một workbook.save(path) lệnh gọi. Sử dụng SaveFormat các hằng số cho việc kiểm soát rõ ràng: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. Sử dụng MarkdownSaveOptions để xuất Markdown chi tiết (căn chỉnh, cấp độ tiêu đề, chỉ mục bảng tính). Sử dụng MarkdownHandler.save_markdown_to_string(wb) để tạo Markdown trong bộ nhớ.

Lưu ý: Aspose.Cells FOSS xuất ra XLSX, CSV, TSV, Markdown và JSON. Xuất PDF, HTML, PNG, TIFF, DOCX và PPTX không thuộc thư viện FOSS.

Hệ sinh thái plugin

Tùy chọn markitdown-aspose-cells-plugin gói tích hợp với thư viện MarkItDown của Microsoft để thêm hỗ trợ đọc XLSX. Cài đặt nó bằng pip install markitdown-aspose-cells-plugin và sử dụng nó một cách liền mạch qua MarkItDown API.

Bắt đầu

Cài đặt 

pip install aspose-cells-foss

Xin chào Thế giới 

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

Xuất ra 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")

Tạo biểu đồ cột 

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

Định dạng ô 

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

Hướng dẫn có sẵn

Xem Thêm

 Tiếng Việt