1. Produkty
  2.   Arkusz
  3.   Rust
  4.   xlsxwriter-rs

xlsxwriter-rs

 
 

Biblioteka Rust do generowania Excel XLSX

Twórz w pełni kompatybilne pliki Excel XLSX z formatowaniem, scalonymi komórkami, autofiltrem i obrazami za pomocą API Rust.

Czym jest xlsxwriter-rs?

xlsxwriter-rs to wysokowydajne powiązanie Rust z szeroko używaną biblioteką C libxlsxwriter, umożliwiające programistom generowanie w pełni kompatybilnych plików Excel XLSX bezpośrednio z aplikacji Rust. Obsługuje kompleksowe formatowanie Excel, w tym czcionki, kolory, wyrównanie, obramowania i formaty liczb, a także zaawansowane funkcje, takie jak scalone komórki, autofiltrowanie, walidacja danych i osadzone obrazy PNG/JPEG. Zaprojektowany z myślą o niezawodności i szybkości, xlsxwriter-rs jest idealny do generowania raportów po stronie serwera, potoków eksportu danych oraz wszelkich scenariuszy wymagających programowego tworzenia plików Excel w Rust.

Biblioteka wykorzystuje bezpieczeństwo pamięci Rust oraz abstrakcje o zerowym koszcie, aby zapewnić bezpieczne i wydajne API do generowania plików Excel bez konieczności posiadania Microsoft Excel ani zewnętrznych zależności, takich jak COM. Integruje się płynnie z Cargo i obsługuje opcjonalne flagi funkcji umożliwiające dostosowanie zachowania, takie jak wyłączanie sum kontrolnych MD5 lub używanie systemowego zlib. Dzięki czystemu, idiomatycznemu interfejsowi Rust oraz obszernej dokumentacji, xlsxwriter-rs umożliwia programistom tworzenie solidnych, wieloplatformowych narzędzi do generowania plików Excel, zachowując pełną kontrolę nad strukturą i zawartością pliku.

Previous Next

Rozpoczęcie pracy z xlsxwriter-rs

Aby rozpocząć korzystanie z xlsxwriter-rs, dodaj go do swojego Cargo.toml za pomocą cargo add xlsxwriter lub ręcznie dołącz [dependencies] z xlsxwriter = \"0.1\". Biblioteka wymaga LLVM i Clanga do kompilacji bindgen. Dla systemu Windows zainstaluj Visual Studio i LLVM, a następnie ustaw LIBCLANG_PATH na katalog bin LLVM. Po konfiguracji sklonuj repozytorium, uruchom git submodule update --init --recursive, aby pobrać bibliotekę C, i zbuduj przykłady przy użyciu cargo run --example hello_spreadsheet. Pełna dokumentacja i przykłady są dostępne na GitHub xlsxwriter-rs.

Zainstaluj xlsxwriter-rs za pomocą Cargo

cargo add xlsxwriter

Pełne wsparcie formatowania Excel

xlsxwriter-rs zapewnia kompleksowe możliwości formatowania, umożliwiając programistom dostosowanie czcionek, kolorów, obramowań, wyrównania i formatów liczb dla pojedynczych komórek lub zakresów. Możesz stosować pogrubienie, kursywę, podkreślenie, rozmiar czcionki oraz niestandardowe kolory tekstu, ustawiać kolory wypełnienia tła, definiować obramowania komórek w różnych stylach (cienkie, średnie, grube) oraz kontrolować wyrównanie poziome/pionowe. Ten poziom kontroli zapewnia, że generowane pliki Excel spełniają profesjonalne standardy raportowania. Formatowanie jest stosowane przy użyciu struktury Format, która obsługuje łańcuchowanie metod dla intuicyjnej konfiguracji. Ta funkcja jest niezbędna do tworzenia wizualnie odróżniających się raportów, pulpitów nawigacyjnych i eksportów danych, które poprawiają czytelność i doświadczenie użytkownika.

Zastosuj kolor czcionki i wyrównanie w komórkach

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

Scalone komórki i zakresy

Biblioteka obsługuje scalanie prostokątnych zakresów komórek, co jest kluczowe przy tworzeniu nagłówków, tytułów i grupowanych sekcji danych w raportach Excel. Korzystając z metody merge_range, możesz rozciągnąć wiele wierszy i kolumn, jednocześnie stosując formatowanie do całego scalonego bloku. Zapewnia to spójny styl i układ w złożonych arkuszach kalkulacyjnych. Scalane komórki są w pełni kompatybilne z silnikiem renderującym Excela i zachowują formatowanie, takie jak wyrównanie tekstu, obramowania i kolory tła. Ta funkcja jest szczególnie przydatna w sprawozdaniach finansowych, pulpitach nawigacyjnych i formularzach, gdzie wizualne grupowanie zwiększa zrozumienie danych i jakość prezentacji.

Scal zakres z niestandardowym formatowaniem

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

Filtry automatyczne i walidacja danych

xlsxwriter-rs umożliwia programowe tworzenie autofiltrow i reguł walidacji danych, pozwalając użytkownikom sortować, filtrować i weryfikować dane bezpośrednio w Excelu. Możesz zastosować autofilter do zakresu komórek używając set_autofilter oraz zdefiniować listy rozwijane dla wprowadzania danych poprzez walidację. Obsługuje to walidację opartą na listach, zakresy liczbowe, daty i własne formuły. Te funkcje zwiększają interaktywność i integralność danych w arkuszach kalkulacyjnych, czyniąc je odpowiednimi dla formularzy, szablonów i współdzielonego wprowadzania danych. Generowane pliki XLSX zachowują pełną funkcjonalność po otwarciu w Excelu, LibreOffice lub Google Sheets, zapewniając szeroką kompatybilność.

Zastosuj autofiltrowanie i walidację danych

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

Osadzanie obrazów i hiperłączy

Możesz osadzać obrazy PNG i JPEG bezpośrednio w arkuszach Excel przy użyciu xlsxwriter-rs, obsługując pozycjonowanie, rozmiarowanie i skalowanie. Jest to idealne rozwiązanie do dodawania logo, wykresów lub wskaźników wizualnych do raportów. Dodatkowo biblioteka obsługuje hiperłącza i adresy URL z konfigurowalnym formatowaniem (np. niebieski tekst i podkreślenia), umożliwiając klikalne odnośniki do stron internetowych, dokumentów lub innych arkuszy. Te możliwości sprawiają, że xlsxwriter-rs nadaje się do tworzenia bogatych, interaktywnych raportów i pulpitów nawigacyjnych, które łączą dane, wizualizacje i nawigację. Wszystkie osadzone treści są w pełni kompatybilne z silnikiem renderującym Excela i zachowują integralność układu na różnych platformach.

Zapisz adres URL i osadź obraz

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