1. Produk
  2.   Hamparan
  3.   Rust
  4.   xlsxwriter-rs

xlsxwriter-rs

 
 

Perpustakaan Rust untuk Penjanaan Excel XLSX

Cipta Fail Excel XLSX yang Sepenuhnya Serasi dengan Pemformatan, Sel Gabungan, Autofilter & Imej melalui API Rust.

Apakah xlsxwriter-rs?

xlsxwriter-rs ialah perpustakaan pengikatan Rust berprestasi tinggi untuk perpustakaan C libxlsxwriter yang banyak digunakan, membolehkan pemaju menghasilkan fail Excel XLSX yang sepenuhnya serasi secara langsung daripada aplikasi Rust. Ia menyokong pemformatan Excel yang menyeluruh, termasuk fon, warna, penjajaran, sempadan, dan format nombor, serta ciri lanjutan seperti sel yang digabungkan, penapis automatik, pengesahan data, dan imej PNG/JPEG terbenam. Direka untuk kebolehpercayaan dan kelajuan, xlsxwriter-rs sesuai untuk penjanaan laporan sisi pelayan, saluran eksport data, dan sebarang senario yang memerlukan penciptaan fail Excel secara programatik dalam Rust.

Pustaka ini memanfaatkan keselamatan memori Rust dan abstraksi tanpa kos tambahan untuk menyediakan API yang selamat dan cekap bagi penjanaan Excel tanpa memerlukan Microsoft Excel atau kebergantungan luaran seperti COM. Ia berintegrasi dengan lancar dengan Cargo dan menyokong bendera ciri pilihan untuk menyesuaikan tingkah laku, seperti melumpuhkan checksum MD5 atau menggunakan zlib sistem. Dengan antara muka Rust yang bersih, idiomatik dan dokumentasi yang komprehensif, xlsxwriter-rs memberi kuasa kepada pembangun untuk membina alat penjanaan Excel yang kukuh dan merentas platform sambil mengekalkan kawalan penuh ke atas struktur dan kandungan fail.

Previous Next

Mula Menggunakan xlsxwriter-rs

Untuk mula menggunakan xlsxwriter-rs, tambahkan ia ke dalam Cargo.toml anda melalui cargo add xlsxwriter atau secara manual sertakan [dependencies] dengan xlsxwriter = "0.1". Perpustakaan ini memerlukan LLVM dan Clang untuk kompilasi bindgen. Untuk Windows, pasang Visual Studio dan LLVM, kemudian tetapkan LIBCLANG_PATH ke direktori bin LLVM. Selepas persediaan, klon repositori, jalankan git submodule update --init --recursive untuk mendapatkan perpustakaan C, dan bina contoh dengan cargo run --example hello_spreadsheet. Dokumentasi penuh dan contoh tersedia di GitHub xlsxwriter-rs.

Pasang xlsxwriter-rs melalui Cargo

cargo add xlsxwriter

Sokongan Pemformatan Excel Penuh

xlsxwriter-rs menyediakan keupayaan pemformatan yang komprehensif, membolehkan pembangun menyesuaikan fon, warna, sempadan, penjajaran, dan format nombor untuk sel atau julat individu. Anda boleh menggunakan tebal, condong, garis bawah, saiz fon, dan warna tersuai pada teks, menetapkan warna latar belakang, menentukan sempadan sel dengan pelbagai gaya (nipis, sederhana, tebal), dan mengawal penjajaran mendatar/menegak. Tahap kawalan ini memastikan fail Excel yang dihasilkan mematuhi piawaian pelaporan profesional. Pemformatan diterapkan menggunakan struktur Format, yang menyokong rantai kaedah untuk konfigurasi yang intuitif. Ciri ini penting untuk mencipta laporan, papan pemuka, dan eksport data yang berbeza secara visual yang meningkatkan kebolehbacaan dan pengalaman pengguna.

Terapkan Warna Fon dan Penjajaran pada Sel

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)
    )
)?;

Sel dan Julat yang Digabungkan

Pustaka ini menyokong penggabungan julat sel segi empat tepat, yang penting untuk membuat tajuk, judul, dan bahagian data berkelompok dalam laporan Excel. Dengan menggunakan kaedah merge_range, anda boleh meliputi beberapa baris dan lajur sambil menerapkan pemformatan pada keseluruhan blok yang digabungkan. Ini memastikan gaya dan susun atur yang konsisten di seluruh hamparan kerja yang kompleks. Sel yang digabungkan sepenuhnya serasi dengan enjin rendering Excel dan mengekalkan pemformatan seperti penjajaran teks, sempadan, dan warna latar belakang. Ciri ini sangat berguna untuk penyata kewangan, papan pemuka, dan borang di mana pengelompokan visual meningkatkan pemahaman data dan kualiti persembahan.

Gabungkan Julat dengan Pemformatan Tersuai

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)
    )
)?;

Penapis Automatik dan Pengesahan Data

xlsxwriter-rs membolehkan penciptaan programatik autofilter dan peraturan pengesahan data, membenarkan pengguna menyusun, menapis, dan mengesahkan data secara langsung dalam Excel. Anda boleh menggunakan autofilter pada satu julat sel dengan set_autofilter, dan menentukan senarai lungsur untuk input pengguna melalui pengesahan data. Ini menyokong pengesahan berasaskan senarai, julat nombor, tarikh, dan formula tersuai. Ciri-ciri ini meningkatkan interaktiviti dan integriti data dalam hamparan kerja, menjadikannya sesuai untuk borang, templat, dan kemasukan data kolaboratif. Fail XLSX yang dijana mengekalkan fungsi penuh apabila dibuka dalam Excel, LibreOffice, atau Google Sheets, memastikan keserasian yang meluas.

Terapkan Penapis Automatik dan Pengesahan Data

// 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"])
)?;

Sisipkan Imej dan Pautan Hiper

Anda boleh menyematkan imej PNG dan JPEG secara langsung ke dalam lembar kerja Excel menggunakan xlsxwriter-rs, menyokong penempatan, saiz, dan skala. Ini ideal untuk menambah logo, carta, atau penunjuk visual kepada laporan. Selain itu, perpustakaan ini menyokong pautan hiper dan URL dengan pemformatan yang boleh disesuaikan (contoh, teks biru dan garis bawah), membolehkan pautan yang boleh diklik ke laman web, dokumen, atau lembar lain. Keupayaan ini menjadikan xlsxwriter-rs sesuai untuk mencipta laporan dan papan pemuka yang kaya, interaktif yang menggabungkan data, visual, dan navigasi. Semua kandungan yang disematkan sepenuhnya serasi dengan enjin rendering Excel dan mengekalkan integriti susun atur merentasi platform.

Tulis URL dan Sisipkan Imej

// 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")?;
 Melayu