1. Producten
  2.   Spreadsheet
  3.   Rust
  4.   xlsxwriter-rs

xlsxwriter-rs

 
 

Rust-bibliotheek voor Excel XLSX-generatie

Maak volledig compatibele Excel XLSX-bestanden met opmaak, samengevoegde cellen, autofilters en afbeeldingen via de Rust-API.

Wat is xlsxwriter-rs?

xlsxwriter-rs is een high-performance Rust-binding voor de veelgebruikte libxlsxwriter C-bibliotheek, waarmee ontwikkelaars direct vanuit Rust-toepassingen volledig compatibele Excel XLSX-bestanden kunnen genereren. Het ondersteunt uitgebreide Excel-opmaak, inclusief lettertypen, kleuren, uitlijning, randen en getalnotaties, evenals geavanceerde functies zoals samengevoegde cellen, autofilters, gegevensvalidatie en ingesloten PNG/JPEG-afbeeldingen. Ontworpen voor betrouwbaarheid en snelheid, is xlsxwriter-rs ideaal voor server-side rapportgeneratie, data-exportpijplijnen en elke situatie die programmatische Excel-bestandcreatie in Rust vereist.

De bibliotheek maakt gebruik van Rust's geheugenveiligheid en zero-cost abstracties om een veilige en efficiënte API voor het genereren van Excel-bestanden te bieden zonder Microsoft Excel of externe afhankelijkheden zoals COM te vereisen. Hij integreert naadloos met Cargo en ondersteunt optionele feature‑flags voor het aanpassen van gedrag, zoals het uitschakelen van MD5‑controles of het gebruiken van systeem‑zlib. Met zijn schone, idiomatische Rust‑interface en uitgebreide documentatie stelt xlsxwriter-rs ontwikkelaars in staat robuuste, platformonafhankelijke Excel‑generatietools te bouwen terwijl ze volledige controle behouden over de bestandsstructuur en inhoud.

Previous Next

Aan de slag met xlsxwriter-rs

Om xlsxwriter-rs te gaan gebruiken, voeg je het toe aan je Cargo.toml via cargo add xlsxwriter of voeg je handmatig [dependencies] toe met xlsxwriter = "0.1". De bibliotheek vereist LLVM en Clang voor bindgen-compilatie. Voor Windows installeer je Visual Studio en LLVM, en stel je LIBCLANG_PATH in op de LLVM bin-map. Na de configuratie kloon je de repository, voer je git submodule update --init --recursive uit om de C-bibliotheek op te halen, en bouw je voorbeelden met cargo run --example hello_spreadsheet. Volledige documentatie en voorbeelden zijn beschikbaar op de xlsxwriter-rs GitHub.

Installeer xlsxwriter-rs via Cargo

cargo add xlsxwriter

Volledige Excel-opmaakondersteuning

xlsxwriter-rs biedt uitgebreide opmaakmogelijkheden, waardoor ontwikkelaars lettertypen, kleuren, randen, uitlijning en getalformaten voor individuele cellen of bereiken kunnen aanpassen. Je kunt vet, cursief, onderstrepen, lettergrootte en aangepaste kleuren op tekst toepassen, achtergrondvulkleur instellen, celranden definiëren met verschillende stijlen (dun, medium, dik), en horizontale/verticale uitlijning regelen. Dit niveau van controle zorgt ervoor dat gegenereerde Excel‑bestanden voldoen aan professionele rapportage‑normen. Opmaak wordt toegepast met de Format-struct, die method chaining ondersteunt voor intuïtieve configuratie. Deze functie is essentieel voor het maken van visueel onderscheidende rapporten, dashboards en data‑exports die de leesbaarheid en gebruikerservaring verbeteren.

Pas letterkleur en uitlijning toe op cellen

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

Samengevoegde cellen en bereiken

De bibliotheek ondersteunt het samenvoegen van rechthoekige celbereiken, wat cruciaal is voor het maken van kopteksten, titels en gegroepeerde gegevenssecties in Excel-rapporten. Met de merge_range-methode kun je meerdere rijen en kolommen overspannen terwijl je opmaak toepast op het gehele samengevoegde blok. Dit zorgt voor consistente styling en lay-out in complexe spreadsheets. Samengevoegde cellen zijn volledig compatibel met de renderengine van Excel en behouden opmaak zoals tekstuitlijning, randen en achtergrondkleuren. Deze functie is vooral nuttig voor financiële overzichten, dashboards en formulieren waarbij visuele groepering het begrip van gegevens en de presentatiekwaliteit verbetert.

Een bereik samenvoegen met aangepaste opmaak

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

Autofilters en gegevensvalidatie

xlsxwriter-rs maakt programmatische creatie van autofilters en gegevensvalidatieregels mogelijk, waardoor gebruikers direct in Excel gegevens kunnen sorteren, filteren en valideren. Je kunt een autofilter toepassen op een bereik van cellen met set_autofilter, en vervolgkeuzelijsten definiëren voor gebruikersinvoer via gegevensvalidatie. Dit ondersteunt lijstgebaseerde validatie, numerieke bereiken, datums en aangepaste formules. Deze functies verbeteren de interactiviteit en gegevensintegriteit in spreadsheets, waardoor ze geschikt zijn voor formulieren, sjablonen en collaboratieve gegevensinvoer. De gegenereerde XLSX-bestanden behouden volledige functionaliteit wanneer ze worden geopend in Excel, LibreOffice of Google Sheets, wat zorgt voor brede compatibiliteit.

Autofilter en gegevensvalidatie toepassen

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

Afbeeldingen en hyperlinks insluiten

U kunt PNG- en JPEG-afbeeldingen direct in Excel-werkbladen insluiten met xlsxwriter-rs, met ondersteuning voor positionering, grootte en schaling. Dit is ideaal voor het toevoegen van logo's, grafieken of visuele indicatoren aan rapporten. Bovendien ondersteunt de bibliotheek hyperlinks en URL's met aanpasbare opmaak (bijv. blauwe tekst en onderstrepingen), waardoor klikbare links naar websites, documenten of andere bladen mogelijk zijn. Deze mogelijkheden maken xlsxwriter-rs geschikt voor het maken van rijke, interactieve rapporten en dashboards die data, visuals en navigatie combineren. Alle ingesloten inhoud is volledig compatibel met de renderengine van Excel en behoudt de lay-outintegriteit op verschillende platforms.

URL schrijven en afbeelding insluiten

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