1. produkty
  2.   Tabulka
  3.   Rust
  4.   xlsxwriter-rs

xlsxwriter-rs

 
 

Rust knihovna pro generování Excel XLSX

Vytvářejte plně kompatibilní soubory Excel XLSX s formátováním, sloučenými buňkami, automatickými filtry a obrázky pomocí Rust API.

Co je xlsxwriter-rs?

xlsxwriter-rs je vysoce výkonná Rust vazba na široce používanou C knihovnu libxlsxwriter, která umožňuje vývojářům generovat plně kompatibilní soubory Excel XLSX přímo z Rust aplikací. Podporuje komplexní formátování Excelu, včetně písem, barev, zarovnání, ohraničení a číselných formátů, stejně jako pokročilé funkce jako sloučené buňky, automatické filtry, validaci dat a vložené PNG/JPEG obrázky. Navržena pro spolehlivost a rychlost, je xlsxwriter-rs ideální pro generování reportů na serverové straně, datové exportní pipeline a jakýkoli scénář vyžadující programové vytváření Excel souborů v Rustu.

Knihovna využívá bezpečnost paměti Rustu a abstrakce bez nákladů, aby poskytla bezpečné a efektivní API pro generování Excel souborů, aniž by vyžadovala Microsoft Excel nebo externí závislosti jako COM. Bez problémů se integruje s Cargo a podporuje volitelné příznaky funkcí pro přizpůsobení chování, například vypnutí kontrolních součtů MD5 nebo použití systémového zlibu. Díky svému čistému, idiomatickému rozhraní v Rustu a komplexní dokumentaci umožňuje xlsxwriter-rs vývojářům vytvářet robustní, multiplatformní nástroje pro generování Excel souborů při zachování úplné kontroly nad strukturou a obsahem souboru.

Previous Next

Začínáme s xlsxwriter-rs

Chcete-li začít používat xlsxwriter-rs, přidejte jej do svého Cargo.toml pomocí cargo add xlsxwriter nebo ručně zahrňte [dependencies] s xlsxwriter = "0.1". Knihovna vyžaduje LLVM a Clang pro kompilaci bindgen. Pro Windows nainstalujte Visual Studio a LLVM, poté nastavte LIBCLANG_PATH na adresář bin LLVM. Po nastavení naklonujte repozitář, spusťte git submodule update --init --recursive pro stažení C knihovny a sestavte příklady pomocí cargo run --example hello_spreadsheet. Úplná dokumentace a příklady jsou k dispozici na GitHubu xlsxwriter-rs.

Instalace xlsxwriter-rs pomocí Cargo

cargo add xlsxwriter

Plná podpora formátování Excelu

xlsxwriter-rs poskytuje komplexní možnosti formátování, které umožňují vývojářům přizpůsobit písma, barvy, okraje, zarovnání a číselné formáty pro jednotlivé buňky nebo rozsahy. Můžete použít tučné, kurzívu, podtržení, velikost písma a vlastní barvy textu, nastavit barvy výplně pozadí, definovat okraje buněk s různými styly (tenký, střední, silný) a řídit vodorovné/svislé zarovnání. Tato úroveň kontroly zajišťuje, že generované soubory Excel odpovídají profesionálním standardům reportování. Formátování se aplikuje pomocí struktury Format, která podporuje řetězení metod pro intuitivní konfiguraci. Tato funkce je nezbytná pro vytváření vizuálně odlišných reportů, dashboardů a exportů dat, které zlepšují čitelnost a uživatelský zážitek.

Použití barvy písma a zarovnání buněk

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

Sloučené buňky a rozsahy

Knihovna podporuje slučování obdélníkových oblastí buněk, což je klíčové pro vytváření záhlaví, titulů a seskupených sekcí dat v Excelových zprávách. Pomocí metody merge_range můžete rozšířit více řádků a sloupců a zároveň aplikovat formátování na celý sloučený blok. To zajišťuje konzistentní styl a rozvržení v komplexních tabulkách. Sloučené buňky jsou plně kompatibilní s vykreslovacím enginem Excelu a zachovávají formátování, jako je zarovnání textu, okraje a barvy pozadí. Tato funkce je zvláště užitečná pro finanční výkazy, řídicí panely a formuláře, kde vizuální seskupení zlepšuje pochopení dat a kvalitu prezentace.

Sloučit oblast s vlastním formátováním

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

Automatické filtry a ověřování dat

xlsxwriter-rs umožňuje programové vytváření automatických filtrů a pravidel pro ověřování dat, což uživatelům umožňuje řadit, filtrovat a ověřovat data přímo v Excelu. Automatický filtr můžete použít na rozsah buněk pomocí set_autofilter a definovat rozbalovací seznamy pro vstup uživatele pomocí ověřování dat. To podporuje ověřování založené na seznamech, číselných rozsazích, datech a vlastních vzorcích. Tyto funkce zvyšují interaktivitu a integritu dat v tabulkách, což je činí vhodnými pro formuláře, šablony a kolaborativní zadávání dat. Vygenerované soubory XLSX si zachovávají plnou funkčnost při otevření v Excelu, LibreOffice nebo Google Sheets, což zajišťuje širokou kompatibilitu.

Použít automatický filtr a validaci dat

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

Vkládání obrázků a hypertextových odkazů

Můžete vkládat obrázky PNG a JPEG přímo do listů Excelu pomocí xlsxwriter-rs, s podporou umístění, velikosti a škálování. To je ideální pro přidání log, grafů nebo vizuálních indikátorů do zpráv. Kromě toho knihovna podporuje hypertextové odkazy a URL s přizpůsobitelným formátováním (např. modrý text a podtržení), což umožňuje klikatelné odkazy na webové stránky, dokumenty nebo jiné listy. Tyto možnosti dělají z xlsxwriter-rs vhodný nástroj pro tvorbu bohatých, interaktivních zpráv a dashboardů, které kombinují data, vizuály a navigaci. Veškerý vložený obsah je plně kompatibilní s vykreslovacím enginem Excelu a zachovává integritu rozvržení napříč platformami.

Zapsat URL a vložit obrázek

// 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")?;
 Čeština