xlsxwriter-rs

 
 

ไลบรารี Rust สำหรับการสร้าง Excel XLSX

สร้างไฟล์ Excel XLSX ที่เข้ากันได้เต็มรูปแบบพร้อมการจัดรูปแบบ, การรวมเซลล์, ตัวกรองอัตโนมัติ & รูปภาพผ่าน API ของ Rust.

xlsxwriter-rs คืออะไร?

xlsxwriter-rs เป็นไบน์ดิง Rust ที่มีประสิทธิภาพสูงสำหรับไลบรารี C libxlsxwriter ที่ใช้กันอย่างแพร่หลาย ทำให้ผู้พัฒนาสามารถสร้างไฟล์ Excel XLSX ที่เข้ากันได้เต็มรูปแบบโดยตรงจากแอปพลิเคชัน Rust รองรับการจัดรูปแบบ Excel อย่างครบถ้วน รวมถึงแบบอักษร สี การจัดแนว เส้นขอบ และรูปแบบตัวเลข รวมถึงคุณลักษณะขั้นสูงเช่น การรวมเซลล์, autofilter, การตรวจสอบข้อมูล, และการฝังรูปภาพ PNG/JPEG ถูกออกแบบเพื่อความน่าเชื่อถือและความเร็ว xlsxwriter-rs เหมาะสำหรับการสร้างรายงานฝั่งเซิร์ฟเวอร์, กระบวนการส่งออกข้อมูล, และสถานการณ์ใด ๆ ที่ต้องการการสร้างไฟล์ Excel อย่างโปรแกรมเมติกใน Rust.

ไลบรารีนี้ใช้ประโยชน์จากความปลอดภัยของหน่วยความจำและการแยกนามธรรมที่ไม่มีค่าใช้จ่ายของ Rust เพื่อให้ API ที่ปลอดภัยและมีประสิทธิภาพสำหรับการสร้างไฟล์ Excel โดยไม่ต้องพึ่งพา Microsoft Excel หรือการพึ่งพาภายนอกเช่น COM มันทำงานร่วมกับ Cargo อย่างไร้รอยต่อและรองรับฟีเจอร์แฟล็กแบบเลือกได้สำหรับการปรับพฤติกรรม เช่น การปิดการตรวจสอบ MD5 หรือการใช้ระบบ zlib ด้วยอินเทอร์เฟซ Rust ที่สะอาดและเป็นธรรมชาติและเอกสารที่ครอบคลุม xlsxwriter-rs ช่วยให้นักพัฒนาสร้างเครื่องมือสร้างไฟล์ Excel ข้ามแพลตฟอร์มที่แข็งแรงในขณะที่ยังคงควบคุมโครงสร้างและเนื้อหาไฟล์ได้อย่างเต็มที่

Previous Next

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

เพื่อเริ่มใช้ xlsxwriter-rs ให้เพิ่มมันลงใน Cargo.toml ของคุณผ่าน cargo add xlsxwriter หรือรวมด้วยตนเอง [dependencies] พร้อมกับ xlsxwriter = "0.1". ไลบรารีนี้ต้องการ LLVM และ Clang สำหรับการคอมไพล์ bindgen สำหรับ Windows ให้ติดตั้ง Visual Studio และ LLVM จากนั้นตั้งค่า LIBCLANG_PATH ไปยังไดเรกทอรี bin ของ LLVM หลังจากตั้งค่าเสร็จ ให้โคลนรีโพซิทอรี รัน git submodule update --init --recursive เพื่อดึงไลบรารี C และสร้างตัวอย่างด้วย cargo run --example hello_spreadsheet เอกสารและตัวอย่างเต็มรูปแบบพร้อมให้ใช้งานบน GitHub ของ xlsxwriter-rs.

ติดตั้ง xlsxwriter-rs ผ่าน Cargo

cargo add xlsxwriter

รองรับการจัดรูปแบบ Excel อย่างเต็มรูปแบบ

xlsxwriter-rs มีความสามารถในการจัดรูปแบบอย่างครบถ้วน ช่วยให้นักพัฒนาสามารถปรับแต่งแบบอักษร สี เส้นขอบ การจัดแนว และรูปแบบตัวเลขสำหรับเซลล์หรือช่วงต่าง ๆ ได้ คุณสามารถใช้ตัวหนา ตัวเอียง ตัวขีดเส้นใต้ ขนาดแบบอักษร และสีที่กำหนดเองกับข้อความ ตั้งค่าสีพื้นหลัง กำหนดเส้นขอบเซลล์ด้วยสไตล์ต่าง ๆ (บาง, ปานกลาง, หนา) และควบคุมการจัดแนวนอน/แนวตั้ง ระดับการควบคุมนี้ทำให้ไฟล์ Excel ที่สร้างขึ้นตรงตามมาตรฐานการรายงานระดับมืออาชีพ การจัดรูปแบบจะถูกนำไปใช้โดยใช้โครงสร้าง Format ซึ่งสนับสนุนการเชื่อมต่อเมธอดเพื่อการกำหนดค่าที่เข้าใจง่าย คุณลักษณะนี้สำคัญสำหรับการสร้างรายงาน แดชบอร์ด และการส่งออกข้อมูลที่มีความแตกต่างทางสายตา ซึ่งช่วยเพิ่มความอ่านง่ายและประสบการณ์ผู้ใช้

กำหนดสีฟอนต์และการจัดแนวให้กับเซลล์

let mut sheet1 = workbook.add_worksheet(None)?;
sheet1.write_string(
    0, 0, 
    "Red text", 
    Some(&Format::new().set_font_color(FormatColor::Red))
)?;
sheet1.write_string(
    2, 0, 
    "Centered green text", 
    Some(&Format::new()
        .set_font_color(FormatColor::Green)
        .set_align(FormatAlignment::CenterAcross)
        .set_vertical_align(FormatVerticalAlignment::VerticalCenter)
    )
)?;

การรวมเซลล์และช่วง

ไลบรารีนี้รองรับการรวมช่วงเซลล์รูปสี่เหลี่ยมผืนผ้า ซึ่งมีความสำคัญต่อการสร้างหัวเรื่อง, ชื่อเรื่อง, และส่วนข้อมูลที่จัดกลุ่มในรายงาน Excel โดยใช้เมธอด merge_range คุณสามารถขยายหลายแถวและหลายคอลัมน์พร้อมกับใช้การจัดรูปแบบกับบล็อกที่รวมทั้งหมด สิ่งนี้ทำให้การจัดสไตล์และเลย์เอาต์สอดคล้องกันในสเปรดชีตที่ซับซ้อน เซลล์ที่รวมเข้าด้วยกันเข้ากันได้อย่างเต็มที่กับเอนจินการแสดงผลของ Excel และรักษาการจัดรูปแบบเช่นการจัดแนวข้อความ, เส้นขอบ, และสีพื้นหลัง ฟีเจอร์นี้มีประโยชน์เป็นพิเศษสำหรับงบการเงิน, แดชบอร์ด, และแบบฟอร์มที่การจัดกลุ่มด้วยภาพช่วยเพิ่มความเข้าใจข้อมูลและคุณภาพการนำเสนอ

รวมช่วงข้อมูลด้วยการจัดรูปแบบแบบกำหนดเอง

sheet1.merge_range(
    2, 0, 
    3, 2, 
    "Hello, world", 
    Some(&Format::new()
        .set_font_color(FormatColor::Green)
        .set_align(FormatAlignment::CenterAcross)
        .set_vertical_align(FormatVerticalAlignment::VerticalCenter)
    )
)?;

ตัวกรองอัตโนมัติและการตรวจสอบข้อมูล

xlsxwriter-rs ช่วยให้สามารถสร้าง autofilters และกฎการตรวจสอบข้อมูลแบบโปรแกรมได้ ทำให้ผู้ใช้สามารถจัดเรียง, กรอง, และตรวจสอบข้อมูลโดยตรงใน Excel ได้ คุณสามารถใช้ autofilter กับช่วงของเซลล์โดยใช้ set_autofilter และกำหนดรายการดรอปดาวน์สำหรับการป้อนข้อมูลของผู้ใช้ผ่านการตรวจสอบข้อมูล ซึ่งรองรับการตรวจสอบแบบรายการ, ช่วงตัวเลข, วันที่, และสูตรที่กำหนดเอง คุณลักษณะเหล่านี้เพิ่มความโต้ตอบและความสมบูรณ์ของข้อมูลในสเปรดชีต ทำให้เหมาะสำหรับแบบฟอร์ม, แม่แบบ, และการป้อนข้อมูลร่วมกัน ไฟล์ XLSX ที่สร้างขึ้นจะคงความสามารถเต็มรูปแบบเมื่อเปิดใน Excel, LibreOffice หรือ Google Sheets เพื่อให้เข้ากันได้อย่างกว้างขวาง

ใช้ Autofilter และการตรวจสอบข้อมูล

// Apply autofilter to A1:C10
sheet1.set_autofilter("A1:C10")?;

// Add data validation (drop-down list) in B2
sheet1.data_validation(
    "B2", 
    DataValidation::new_list(&["Option1", "Option2", "Option3"])
)?;

ฝังรูปภาพและลิงก์

คุณสามารถฝังภาพ PNG และ JPEG ลงในแผ่นงาน Excel โดยตรงด้วย xlsxwriter-rs ซึ่งรองรับการจัดตำแหน่ง การปรับขนาด และการสเกล นี่เป็นทางเลือกที่เหมาะสำหรับการเพิ่มโลโก้ แผนภูมิ หรือสัญญาณภาพในรายงาน นอกจากนี้ไลบรารียังรองรับไฮเปอร์ลิงก์และ URL พร้อมการจัดรูปแบบที่ปรับแต่งได้ (เช่น ข้อความสีน้ำเงินและขีดเส้นใต้) ทำให้สามารถคลิกเพื่อไปยังเว็บไซต์ เอกสาร หรือแผ่นงานอื่น ๆ ความสามารถเหล่านี้ทำให้ xlsxwriter-rs เหมาะสำหรับการสร้างรายงานและแดชบอร์ดที่มีความหลากหลายและโต้ตอบได้ ซึ่งรวมข้อมูล ภาพและการนำทาง เนื้อหาที่ฝังทั้งหมดเข้ากันได้อย่างเต็มที่กับเอนจินการแสดงผลของ Excel และรักษาความสมบูรณ์ของเลย์เอาต์ข้ามแพลตฟอร์ม

เขียน URL และฝังรูปภาพ

// Write a clickable URL
sheet1.write_url(
    1, 1,
    "https://github.com/informationsea/xlsxwriter-rs",
    Some(&Format::new()
        .set_font_color(FormatColor::Blue)
        .set_underline(FormatUnderline::Single)
    )
)?;

// Embed an image (requires image path)
// sheet1.insert_image(5, 0, "logo.png")?;
 ไทย