1. Produkter
  2.   Kalkylblad
  3.   Rust
  4.   xlsxwriter-rs

xlsxwriter-rs

 
 

Rust-bibliotek för generering av Excel XLSX

Skapa fullt kompatibla Excel XLSX-filer med formatering, sammanslagna celler, autofilter och bilder via Rust API.

Vad är xlsxwriter-rs?

xlsxwriter-rs är ett högpresterande Rust‑bindning för det allmänt använda libxlsxwriter C‑biblioteket, vilket möjliggör för utvecklare att generera fullt kompatibla Excel XLSX‑filer direkt från Rust‑applikationer. Det stödjer omfattande Excel‑formatering, inklusive typsnitt, färger, justering, kanter och talformat, samt avancerade funktioner som sammanslagna celler, autofilter, datavalidering och inbäddade PNG/JPEG‑bilder. Designad för pålitlighet och hastighet är xlsxwriter-rs idealisk för server‑sidig rapportgenerering, dataexport‑pipelines och alla scenarier som kräver programmatisk skapande av Excel‑filer i Rust.

Biblioteket utnyttjar Rusts minnessäkerhet och nollkostnadsabstraktioner för att erbjuda ett säkert och effektivt API för Excel-generering utan att kräva Microsoft Excel eller externa beroenden som COM. Det integreras sömlöst med Cargo och stöder valfria funktionsflaggor för att anpassa beteendet, såsom att inaktivera MD5-kontroller eller använda system-zlib. Med sitt rena, idiomatiska Rust-gränssnitt och omfattande dokumentation ger xlsxwriter-rs utvecklare möjlighet att bygga robusta, plattformsoberoende verktyg för Excel-generering samtidigt som de behåller full kontroll över filstruktur och innehåll.

Previous Next

Komma igång med xlsxwriter-rs

För att börja använda xlsxwriter-rs, lägg till det i din Cargo.toml via cargo add xlsxwriter eller inkludera manuellt [dependencies] med xlsxwriter = \"0.1\". Biblioteket kräver LLVM och Clang för bindgen-kompilering. För Windows, installera Visual Studio och LLVM, sätt sedan LIBCLANG_PATH till LLVM:s bin-katalog. Efter installationen, klona repot, kör git submodule update --init --recursive för att hämta C-biblioteket, och bygg exempel med cargo run --example hello_spreadsheet. Fullständig dokumentation och exempel finns på xlsxwriter-rs GitHub.

Installera xlsxwriter-rs via Cargo

cargo add xlsxwriter

Fullt stöd för Excel-formatering

xlsxwriter-rs erbjuder omfattande formateringsmöjligheter, vilket gör det möjligt för utvecklare att anpassa teckensnitt, färger, kantlinjer, justering och talformat för enskilda celler eller områden. Du kan applicera fetstil, kursiv, understrykning, teckenstorlek och anpassade färger på text, sätta bakgrundsfyllningsfärger, definiera cellkantlinjer med olika stilar (tunn, medium, tjock) och kontrollera horisontell/vertikal justering. Denna nivå av kontroll säkerställer att genererade Excel-filer uppfyller professionella rapportstandarder. Formatering tillämpas med hjälp av Format-strukturen, som stöder metodkedjning för intuitiv konfiguration. Denna funktion är avgörande för att skapa visuellt distinkta rapporter, instrumentpaneler och dataexporter som förbättrar läsbarhet och användarupplevelse.

Applicera teckensnittsfärg och justering på celler

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

Sammanfogade celler och områden

Biblioteket stödjer sammanslagning av rektangulära cellområden, vilket är kritiskt för att skapa rubriker, titlar och grupperade datasektioner i Excel-rapporter. Med metoden merge_range kan du sträcka över flera rader och kolumner samtidigt som du applicerar formatering på hela det sammanslagna blocket. Detta säkerställer enhetlig stil och layout i komplexa kalkylblad. Sammanfogade celler är fullt kompatibla med Excels renderingsmotor och bevarar formatering såsom textjustering, kanter och bakgrundsfärger. Denna funktion är särskilt användbar för finansiella rapporter, instrumentpaneler och formulär där visuell gruppering förbättrar datförståelse och presentationskvalitet.

Slå samman ett område med anpassad formatering

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

Autofilter och datavalidering

xlsxwriter-rs möjliggör programmatisk skapande av autofilter och datavalideringsregler, vilket låter användare sortera, filtrera och validera data direkt i Excel. Du kan tillämpa ett autofilter på ett cellområde med set_autofilter, och definiera rullgardinslistor för användarinmatning via datavalidering. Detta stöder listbaserad validering, numeriska intervall, datum och anpassade formler. Dessa funktioner förbättrar interaktivitet och dataintegritet i kalkylblad, vilket gör dem lämpliga för formulär, mallar och samarbetsinmatning. De genererade XLSX-filerna behåller full funktionalitet när de öppnas i Excel, LibreOffice eller Google Sheets, vilket säkerställer bred kompatibilitet.

Tillämpa autofilter och datavalidering

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

Bädda in bilder och hyperlänkar

Du kan bädda in PNG- och JPEG-bilder direkt i Excel-arbetsblad med xlsxwriter-rs, med stöd för positionering, storlek och skalning. Detta är idealiskt för att lägga till logotyper, diagram eller visuella indikatorer i rapporter. Dessutom stöder biblioteket hyperlänkar och URL:er med anpassningsbar formatering (t.ex. blå text och understrykningar), vilket möjliggör klickbara länkar till webbplatser, dokument eller andra blad. Dessa funktioner gör xlsxwriter-rs lämplig för att skapa rika, interaktiva rapporter och instrumentpaneler som kombinerar data, visuella element och navigation. Allt inbäddat innehåll är fullt kompatibelt med Excels renderingsmotor och bevarar layoutens integritet över plattformar.

Skriv URL och bädda in bild

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