
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.
เริ่มต้นใช้งาน 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();
