1. Produk
  2.   Hamparan
  3.   Rust
  4.   umya-spreadsheet

umya-spreadsheet

 
 

Perpustakaan Rust Tulen untuk Fail XLSX/XLSM

Baca, Tulis, Gaya, dan Manipulasi Hamparan XLSX/XLSM dengan Tiada Kebergantungan Luaran.

Apakah umya-spreadsheet?

umya-spreadsheet ialah perpustakaan Rust tulen berprestasi tinggi untuk membaca dan menulis fail spreadsheet Excel dalam format XLSX dan XLSM. Direka untuk keselamatan dan kecekapan, ia mengelakkan kod tidak selamat dan kebergantungan luaran, menjadikannya ideal untuk aplikasi desktop, pemprosesan sisi pelayan, dan persekitaran WebAssembly. Perpustakaan ini menyediakan API Rust yang bersih dan idiomatik untuk mengakses sel, baris, lajur, gaya, carta, dan imej, membolehkan pembangun membina alat spreadsheet yang kukuh tanpa bergantung pada Microsoft Office atau interop COM.

Dengan sokongan penuh untuk pemuatan malas, perlindungan kata laluan, dan pemformatan yang kaya, umya-spreadsheet menjembatani jurang antara prestasi dan kebolehgunaan. Ia menyokong pengeksportan CSV, penjanaan carta, penyisipan imej, dan operasi julat seperti memindahkan dan menyalin. Projek ini diselenggara secara aktif, didokumentasikan dengan baik, dan diuji, dengan fokus pada ketepatan dan keserasian dengan ciri-ciri Excel moden. Pembangun boleh mengintegrasikannya ke dalam alat CLI, backend web, atau aplikasi desktop menggunakan kerangka kerja seperti Tauri atau Axo.

Previous Next

Mula Menggunakan umya-spreadsheet

Untuk mula menggunakan umya-spreadsheet, tambahkan ia ke dalam Cargo.toml anda dengan `umya-spreadsheet = "3.1.1"`. Untuk sokongan WebAssembly, aktifkan ciri `js`. Pustaka ini ringan pada kebergantungan dan disusun dengan cepat. Setelah dipasang, import ia melalui `extern crate umya_spreadsheet;` dan mulakan membaca atau menulis hamparan kerja. Anda juga boleh meneroka GitHub umya-spreadsheet untuk contoh, ujian, dan dokumentasi. Ia menyokong pemuatan malas untuk fail besar dan menawarkan pengendalian ralat yang kukuh.

Pasang umya-spreadsheet melalui Cargo

[dependencies]
umya-spreadsheet = "3.1.1"

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

Baca & Tulis Fail XLSX/XLSM

umya-spreadsheet menyediakan API yang intuitif untuk membaca dan menulis fail XLSX dan XLMS. Gunakan `reader::xlsx::read()` untuk memuatkan buku kerja dari cakera, atau `new_file()` untuk membuat satu yang kosong. Penulisan juga sama mudah: panggil `writer::xlsx::write()` dengan buku kerja dan laluan sasaran. Perpustakaan menyokong pemuatan malas melalui `lazy_read()` untuk prestasi yang lebih baik pada fail besar, dan membenarkan penulisan yang dilindungi kata laluan atau menetapkan kata laluan selepas penciptaan. Semua operasi selamat, tanpa salinan bila boleh, dan mengelakkan binari luaran.

Bagaimana Membaca dan Menulis Fail XLSX melalui 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();

Akses Sel & Manipulasi Gaya

Mengakses dan mengubah nilai sel adalah mudah: gunakan `cell("A1")` atau `cell((1,1))` untuk membaca, dan `cell_mut()` untuk menulis. Gaya diurus melalui `style_mut()`, membenarkan perubahan warna latar belakang, fon, sempadan, dan penjajaran. Perpustakaan memaparkan set gaya yang kaya sambil mengekalkan jaminan ketidakubahsuaian bila boleh. Anda juga boleh mendapatkan nilai berformat, menerapkan logik bersyarat, dan mengemas kini gaya secara pukal merentasi julat. Ini menjadikannya ideal untuk menjana laporan, papan pemuka, atau eksport data dengan pemformatan yang konsisten.

Bagaimana Mengubah Nilai Sel dan Gaya dengan 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);

Sokongan Carta & Imej

umya-spreadsheet menyokong penciptaan dan penyuntingan carta—termasuk carta garis, bar, dan kawasan—dengan menentukan julat siri dan penanda. Anda boleh menyematkan imej secara langsung ke dalam helaian menggunakan struktur `Image`, dengan sokongan untuk PNG dan format lain bergantung pada ciri yang diaktifkan. Carta dan imej berintegrasi dengan lancar dengan koordinat sel dan lapisan lukisan, membolehkan penjanaan papan pemuka dinamik. Walaupun beberapa ciri lukisan lanjutan masih dalam perkembangan, fungsi teras sudah sedia untuk pengeluaran dan boleh dikembangkan.

Bagaimana Menambah Carta Garis ke Spreadsheet dengan 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);

Operasi Julat & Perlindungan Kata Laluan

Lakukan operasi lanjutan seperti memindahkan, menyalin, dan menukar saiz julat menggunakan `move_range()`, membolehkan penyusunan semula data secara dinamik. Perpustakaan ini juga menyokong buku kerja yang dilindungi kata laluan: menulis fail dengan `write_with_password()` atau menetapkan kata laluan pada fail sedia ada melalui `set_password()`. Ciri-ciri ini penting untuk pengendalian data yang selamat dalam aplikasi perusahaan atau yang sensitif kepada pematuhan. Digabungkan dengan reka bentuk tanpa kebergantungan dan keserasian WASM, umya-spreadsheet menyediakan kedua-dua fleksibiliti dan keselamatan.

Bagaimana Memindahkan Julat dan Melindungi Fail dengan Kata Laluan melalui 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();
 Melayu