
xlsxwriter-rs
Perpustakaan Rust untuk Pembuatan Excel XLSX
Buat File Excel XLSX yang Sepenuhnya Kompatibel dengan Format, Sel yang Digabung, Autofilter & Gambar melalui API Rust.
Apa itu xlsxwriter-rs?
xlsxwriter-rs adalah binding Rust berkinerja tinggi untuk pustaka C libxlsxwriter yang banyak digunakan, memungkinkan pengembang menghasilkan file Excel XLSX yang sepenuhnya kompatibel langsung dari aplikasi Rust. Ini mendukung pemformatan Excel yang komprehensif, termasuk font, warna, perataan, batas, dan format angka, serta fitur lanjutan seperti sel yang digabungkan, autofilter, validasi data, dan gambar PNG/JPEG yang disisipkan. Dirancang untuk keandalan dan kecepatan, xlsxwriter-rs ideal untuk pembuatan laporan sisi server, pipeline ekspor data, dan skenario apa pun yang memerlukan pembuatan file Excel secara programatik dalam Rust.
Pustaka ini memanfaatkan keamanan memori Rust dan abstraksi tanpa biaya untuk menyediakan API yang aman dan efisien untuk pembuatan Excel tanpa memerlukan Microsoft Excel atau ketergantungan eksternal seperti COM. Ia terintegrasi secara mulus dengan Cargo dan mendukung flag fitur opsional untuk menyesuaikan perilaku, seperti menonaktifkan checksum MD5 atau menggunakan zlib sistem. Dengan antarmuka Rust yang bersih dan idiomatik serta dokumentasi yang komprehensif, xlsxwriter-rs memberdayakan pengembang untuk membangun alat pembuatan Excel lintas platform yang kuat sambil mempertahankan kontrol penuh atas struktur dan konten file.
Memulai dengan xlsxwriter-rs
Untuk mulai menggunakan xlsxwriter-rs, tambahkan ke 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, instal Visual Studio dan LLVM, lalu setel LIBCLANG_PATH ke direktori bin LLVM. Setelah penyiapan, kloning repositori, jalankan git submodule update --init --recursive untuk mengambil pustaka C, dan bangun contoh dengan cargo run --example hello_spreadsheet. Dokumentasi lengkap dan contoh tersedia di GitHub xlsxwriter-rs.
Instal xlsxwriter-rs melalui Cargo
cargo add xlsxwriterDukungan Pemformatan Excel Lengkap
xlsxwriter-rs menyediakan kemampuan pemformatan yang komprehensif, memungkinkan pengembang untuk menyesuaikan font, warna, batas, perataan, dan format angka untuk sel atau rentang individu. Anda dapat menerapkan teks tebal, miring, bergaris bawah, ukuran font, dan warna khusus pada teks, mengatur warna latar belakang, mendefinisikan batas sel dengan berbagai gaya (tipis, sedang, tebal), dan mengontrol perataan horizontal/vertikal. Tingkat kontrol ini memastikan file Excel yang dihasilkan sesuai dengan standar pelaporan profesional. Pemformatan diterapkan menggunakan struktur Format, yang mendukung chaining metode untuk konfigurasi yang intuitif. Fitur ini penting untuk membuat laporan, dasbor, dan ekspor data yang secara visual berbeda, meningkatkan keterbacaan dan pengalaman pengguna.
Terapkan Warna Font 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 Rentang yang Digabung
Pustaka ini mendukung penggabungan rentang sel persegi panjang, yang penting untuk membuat header, judul, dan bagian data yang dikelompokkan dalam laporan Excel. Dengan menggunakan metode merge_range, Anda dapat menggabungkan beberapa baris dan kolom sekaligus sambil menerapkan pemformatan pada seluruh blok yang digabungkan. Ini memastikan gaya dan tata letak yang konsisten di seluruh spreadsheet yang kompleks. Sel yang digabungkan sepenuhnya kompatibel dengan mesin rendering Excel dan mempertahankan pemformatan seperti perataan teks, batas, dan warna latar belakang. Fitur ini sangat berguna untuk laporan keuangan, dasbor, dan formulir di mana pengelompokan visual meningkatkan pemahaman data dan kualitas presentasi.
Gabungkan Rentang dengan Pemformatan Kustom
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)
)
)?;Filter Otomatis dan Validasi Data
xlsxwriter-rs memungkinkan pembuatan programatis autofilter dan aturan validasi data, memungkinkan pengguna untuk menyortir, memfilter, dan memvalidasi data langsung di Excel. Anda dapat menerapkan autofilter pada rentang sel menggunakan set_autofilter, dan mendefinisikan daftar drop-down untuk input pengguna melalui validasi data. Ini mendukung validasi berbasis daftar, rentang numerik, tanggal, dan formula khusus. Fitur-fitur ini meningkatkan interaktivitas dan integritas data dalam spreadsheet, menjadikannya cocok untuk formulir, templat, dan entri data kolaboratif. File XLSX yang dihasilkan mempertahankan fungsionalitas penuh saat dibuka di Excel, LibreOffice, atau Google Sheets, memastikan kompatibilitas yang luas.
Terapkan Autofilter dan Validasi 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"])
)?;Sematkan Gambar dan Tautan
Anda dapat menyematkan gambar PNG dan JPEG secara langsung ke dalam lembar kerja Excel menggunakan xlsxwriter-rs, mendukung penempatan, pengukuran ukuran, dan skala. Ini ideal untuk menambahkan logo, diagram, atau indikator visual ke laporan. Selain itu, pustaka ini mendukung hyperlink dan URL dengan pemformatan yang dapat disesuaikan (mis., teks biru dan garis bawah), memungkinkan tautan yang dapat diklik ke situs web, dokumen, atau lembar lain. Kemampuan ini membuat xlsxwriter-rs cocok untuk membuat laporan dan dasbor interaktif yang kaya, yang menggabungkan data, visual, dan navigasi. Semua konten yang disematkan sepenuhnya kompatibel dengan mesin render Excel dan mempertahankan integritas tata letak di seluruh platform.
Tulis URL dan Sisipkan Gambar
// 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")?;