umya-spreadsheet

 
 

ไลบรารี Rust แท้สำหรับไฟล์ XLSX/XLSM

อ่าน, เขียน, สไตล์, และจัดการสเปรดชีต XLSX/XLSM โดยไม่มีการพึ่งพาภายนอกเลย.

umya-spreadsheet คืออะไร?

umya-spreadsheet เป็นไลบรารี Rust แท้ที่มีประสิทธิภาพสูงสำหรับการอ่านและเขียนไฟล์สเปรดชีต Excel ในรูปแบบ XLSX และ XLSM. ออกแบบเพื่อความปลอดภัยและประสิทธิภาพ มันหลีกเลี่ยงการใช้โค้ดที่ไม่ปลอดภัยและการพึ่งพาภายนอก ทำให้เหมาะสำหรับแอปพลิเคชันเดสก์ท็อป การประมวลผลฝั่งเซิร์ฟเวอร์ และสภาพแวดล้อม WebAssembly. ไลบรารีนี้ให้ API Rust ที่สะอาดและเป็นธรรมชาติสำหรับการเข้าถึงเซลล์ แถว คอลัมน์ สไตล์ แผนภูมิ และรูปภาพ ช่วยให้นักพัฒนาสร้างเครื่องมือสเปรดชีตที่แข็งแรงโดยไม่ต้องพึ่งพา Microsoft Office หรือ COM interop.

ด้วยการสนับสนุนเต็มรูปแบบสำหรับการโหลดแบบ lazy, การป้องกันด้วยรหัสผ่าน, และการจัดรูปแบบที่หลากหลาย, umya-spreadsheet เชื่อมช่องว่างระหว่างประสิทธิภาพและการใช้งานได้อย่างลงตัว. มันรองรับการส่งออกเป็น CSV, การสร้างแผนภูมิ, การฝังรูปภาพ, และการดำเนินการกับช่วงเช่นการย้ายและคัดลอก. โครงการนี้ได้รับการดูแลอย่างต่อเนื่อง, มีเอกสารที่ครบถ้วน, และผ่านการทดสอบ, โดยมุ่งเน้นที่ความถูกต้องและความเข้ากันได้กับฟีเจอร์ Excel สมัยใหม่. นักพัฒนาสามารถผสานรวมมันเข้ากับเครื่องมือ CLI, backend เว็บ, หรือแอปเดสก์ท็อปโดยใช้เฟรมเวิร์กเช่น Tauri หรือ Axo.

Previous Next

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

เพื่อเริ่มใช้ umya-spreadsheet ให้เพิ่มมันลงในไฟล์ Cargo.toml ของคุณด้วย `umya-spreadsheet = "3.1.1"` สำหรับการสนับสนุน WebAssembly ให้เปิดฟีเจอร์ `js` ไลบรารีนี้มีการพึ่งพาน้อยและคอมไพล์เร็ว เมื่อทำการติดตั้งแล้ว ให้นำเข้าโดยใช้ `extern crate umya_spreadsheet;` และเริ่มอ่านหรือเขียนสเปรดชีต คุณยังสามารถสำรวจ umya-spreadsheet GitHub เพื่อดูตัวอย่าง การทดสอบ และเอกสารเพิ่มเติม มันรองรับการโหลดแบบ lazy สำหรับไฟล์ขนาดใหญ่และให้การจัดการข้อผิดพลาดที่แข็งแรง

ติดตั้ง umya-spreadsheet ผ่าน Cargo

[dependencies]
umya-spreadsheet = "3.1.1"

# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }

อ่านและเขียนไฟล์ XLSX/XLSM

umya-spreadsheet ให้ API ที่ใช้งานง่ายสำหรับการอ่านและเขียนไฟล์ XLSX และ XLMS ใช้ `reader::xlsx::read()` เพื่อโหลดเวิร์กบุ๊กจากดิสก์ หรือ `new_file()` เพื่อสร้างไฟล์เปล่า การเขียนก็ง่ายเช่นกัน: เรียก `writer::xlsx::write()` พร้อมกับเวิร์กบุ๊กและเส้นทางเป้าหมาย ไลบรารีรองรับการโหลดแบบ lazy ผ่าน `lazy_read()` เพื่อเพิ่มประสิทธิภาพเมื่อไฟล์ขนาดใหญ่ และอนุญาตให้เขียนด้วยการป้องกันด้วยรหัสผ่านหรือกำหนดรหัสผ่านหลังการสร้าง ทุกการดำเนินการปลอดภัย, ทำสำเนาเป็นศูนย์เมื่อเป็นไปได้, และหลีกเลี่ยงไบนารีภายนอก

วิธีอ่านและเขียนไฟล์ XLSX ด้วย Rust?

use std::path::Path;

// Read file
let path = Path::new("./input.xlsx");
let mut book = umya_spreadsheet::reader::xlsx::read(path).unwrap();

// Write file
let out_path = Path::new("./output.xlsx");
umya_spreadsheet::writer::xlsx::write(&book, out_path).unwrap();

การเข้าถึงเซลล์และการจัดการสไตล์

การเข้าถึงและแก้ไขค่าของเซลล์ทำได้อย่างง่ายดาย: ใช้ `cell("A1")` หรือ `cell((1,1))` สำหรับการอ่าน, และ `cell_mut()` สำหรับการเขียน สไตล์จัดการผ่าน `style_mut()` ซึ่งอนุญาตให้เปลี่ยนสีพื้นหลัง, ฟอนต์, เส้นขอบ, และการจัดแนว ไลบรารีเปิดเผยชุดคุณสมบัติสไตล์ที่หลากหลายพร้อมการรับประกันความไม่เปลี่ยนแปลงเมื่อเป็นไปได้ คุณยังสามารถดึงค่าที่จัดรูปแบบ, ใช้ตรรกะเชิงเงื่อนไข, และอัปเดตสไตล์เป็นกลุ่มในช่วงต่าง ๆ สิ่งนี้ทำให้เหมาะสำหรับการสร้างรายงาน, แดชบอร์ด, หรือการส่งออกข้อมูลด้วยการจัดรูปแบบที่สอดคล้องกัน

วิธีแก้ไขค่าเซลล์และสไตล์ผ่าน Rust?

let mut book = umya_spreadsheet::new_file();
book.sheet_by_name_mut("Sheet1")
    .unwrap()
    .cell_mut("A1")
    .set_value("Hello, Rust!");

let mut style = book.sheet_by_name_mut("Sheet1")
    .unwrap()
    .style_mut("A1");
style.set_background_color(umya_spreadsheet::Color::COLOR_RED);

การสนับสนุนแผนภูมิและรูปภาพ

umya-spreadsheet รองรับการสร้างและแก้ไขแผนภูมิ—รวมถึงแผนภูมิเส้น, แผนภูมิแท่ง, และแผนภูมิพื้นที่—โดยกำหนดช่วงข้อมูลและเครื่องหมาย คุณสามารถฝังรูปภาพโดยตรงลงในแผ่นงานโดยใช้โครงสร้าง `Image` ซึ่งรองรับ PNG และรูปแบบอื่น ๆ ขึ้นอยู่กับคุณสมบัติที่เปิดใช้งาน แผนภูมิและรูปภาพทำงานร่วมกันอย่างไร้รอยต่อกับพิกัดเซลล์และชั้นการวาด, ทำให้สามารถสร้างแดชบอร์ดแบบไดนามิกได้ แม้ว่าบางคุณสมบัติการวาดขั้นสูงยังอยู่ในระหว่างการพัฒนา, ฟังก์ชันหลักพร้อมใช้งานในผลิตภัณฑ์และขยายได้

วิธีเพิ่มแผนภูมิเส้นลงในสเปรดชีตผ่าน Rust?

let mut book = umya_spreadsheet::new_file();
let mut from_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
from_marker.set_coordinate("C1");
let mut to_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
to_marker.set_coordinate("D11");
let series = vec!["Sheet1!$A$1:$A$10", "Sheet1!$B$1:$B$10"];
let mut chart = umya_spreadsheet::structs::Chart::default();
chart.new_chart(
    umya_spreadsheet::structs::ChartType::LineChart,
    from_marker,
    to_marker,
    series,
);
book.sheet_by_name_mut("Sheet1")
    .unwrap()
    .add_chart(chart);

การดำเนินการช่วงและการป้องกันด้วยรหัสผ่าน

ทำการดำเนินการขั้นสูงเช่นการย้าย, คัดลอก, และปรับขนาดช่วงโดยใช้ `move_range()` ซึ่งช่วยให้จัดระเบียบข้อมูลแบบไดนามิกได้ ไลบรารีนี้ยังรองรับสมุดงานที่มีการป้องกันด้วยรหัสผ่าน: เขียนไฟล์ด้วย `write_with_password()` หรือกำหนดรหัสผ่านให้กับไฟล์ที่มีอยู่ผ่าน `set_password()` คุณลักษณะเหล่านี้สำคัญสำหรับการจัดการข้อมูลอย่างปลอดภัยในแอปพลิเคชันระดับองค์กรหรือที่ต้องปฏิบัติตามข้อกำหนดร่วมกับการออกแบบที่ไม่มีการพึ่งพาไลบรารีภายนอกและความเข้ากันได้กับ WASM, umya-spreadsheet มอบความยืดหยุ่นและความปลอดภัยพร้อมกัน

วิธีย้ายช่วงและป้องกันไฟล์ด้วยรหัสผ่านผ่าน Rust?

// Move range
let range = "A1:A3";
book.sheet_by_name_mut("Sheet1")
    .unwrap()
    .move_range(range, &10, &2);

// Password protection
umya_spreadsheet::writer::xlsx::write_with_password(
    &book,
    Path::new("./protected.xlsx"),
    "mypassword",
).unwrap();
 ไทย