
xlsxwriter-rs
Rust-bibliotek for generering av Excel XLSX
Lag fullt kompatible Excel XLSX-filer med formatering, sammenslåtte celler, autofiltre og bilder via Rust-API.
Hva er xlsxwriter-rs?
xlsxwriter-rs er en høyytelses Rust-binding for det mye brukte libxlsxwriter C-biblioteket, som gjør det mulig for utviklere å generere fullt kompatible Excel XLSX-filer direkte fra Rust-applikasjoner. Den støtter omfattende Excel-formatering, inkludert skrifttyper, farger, justering, kantlinjer og tallformater, samt avanserte funksjoner som sammenslåtte celler, autofilter, datavalidering og innebygde PNG/JPEG-bilder. Designet for pålitelighet og hastighet, er xlsxwriter-rs ideell for rapportgenerering på serversiden, dataeksport‑pipelines og enhver situasjon som krever programmatisk opprettelse av Excel-filer i Rust.
Biblioteket utnytter Rusts minnesikkerhet og nullkostnadsabstraksjoner for å tilby et trygt og effektivt API for Excel-generering uten å kreve Microsoft Excel eller eksterne avhengigheter som COM. Det integreres sømløst med Cargo og støtter valgfrie funksjonsflagg for å tilpasse oppførselen, som å deaktivere MD5-sjekksummer eller bruke system-zlib. Med sitt rene, idiomatiske Rust-grensesnitt og omfattende dokumentasjon gir xlsxwriter-rs utviklere muligheten til å bygge robuste, plattformuavhengige Excel-genereringsverktøy samtidig som de beholder full kontroll over filstruktur og innhold.
Kom i gang med xlsxwriter-rs
Begynn å bruke xlsxwriter-rs ved å legge den til i Cargo.toml via cargo add xlsxwriter eller manuelt inkludere [dependencies] med xlsxwriter = "0.1". Biblioteket krever LLVM og Clang for bindgen-kompilering. For Windows, installer Visual Studio og LLVM, og sett deretter LIBCLANG_PATH til LLVM bin-katalogen. Etter oppsett, klon repositoriet, kjør git submodule update --init --recursive for å hente C-biblioteket, og bygg eksempler med cargo run --example hello_spreadsheet. Full dokumentasjon og eksempler er tilgjengelige på xlsxwriter-rs GitHub.
Installer xlsxwriter-rs via Cargo
cargo add xlsxwriterFull støtte for Excel-formattering
xlsxwriter-rs gir omfattende formateringsmuligheter, og gjør det mulig for utviklere å tilpasse skrifttyper, farger, kantlinjer, justering og tallformater for individuelle celler eller områder. Du kan bruke fet, kursiv, understreket, skriftstørrelse og egendefinerte farger på tekst, sette bakgrunnsfyllfarger, definere cellekantlinjer med ulike stiler (tynn, medium, tykk), og kontrollere horisontal/vertikal justering. Dette nivået av kontroll sikrer at genererte Excel-filer samsvarer med profesjonelle rapporteringsstandarder. Formatering brukes ved hjelp av Format-strukturen, som støtter metodekjeding for intuitiv konfigurasjon. Denne funksjonen er essensiell for å lage visuelt distinkte rapporter, dashbord og dataeksport som forbedrer lesbarhet og brukeropplevelse.
Bruk skriftfarge og 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)
)
)?;Sammenslåtte celler og områder
Biblioteket støtter sammenslåing av rektangulære celleområder, noe som er kritisk for å lage overskrifter, titler og grupperte dataseksjoner i Excel-rapporter. Ved å bruke merge_range-metoden kan du dekke flere rader og kolonner samtidig som du anvender formatering på hele det sammenslåtte blokket. Dette sikrer konsistent stil og oppsett på tvers av komplekse regneark. Sammenføyde celler er fullt kompatible med Excels renderingsmotor og bevarer formatering som tekstjustering, kantlinjer og bakgrunnsfarger. Denne funksjonen er spesielt nyttig for finansregnskap, dashbord og skjemaer hvor visuell gruppering forbedrer datakomprehensjon og presentasjonskvalitet.
Slå sammen et område med egendefinert 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)
)
)?;Autofiltere og datavalidering
xlsxwriter-rs gjør det mulig å programmere opprettelse av autofiltere og datavalideringsregler, slik at brukere kan sortere, filtrere og validere data direkte i Excel. Du kan bruke et autofilter på et celleområde ved å bruke set_autofilter, og definere rullegardinlister for brukerinput via datavalidering. Dette støtter listebasert validering, numeriske områder, datoer og egendefinerte formler. Disse funksjonene forbedrer interaktivitet og dataintegritet i regneark, og gjør dem egnet for skjemaer, maler og samarbeidende dataregistrering. De genererte XLSX-filene beholder full funksjonalitet når de åpnes i Excel, LibreOffice eller Google Sheets, og sikrer bred kompatibilitet.
Bruk autofilter og 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"])
)?;Inkluder bilder og hyperkoblinger
Du kan sette inn PNG- og JPEG-bilder direkte i Excel-regneark ved hjelp av xlsxwriter-rs, med støtte for posisjonering, størrelsesjustering og skalering. Dette er ideelt for å legge til logoer, diagrammer eller visuelle indikatorer i rapporter. I tillegg støtter biblioteket hyperkoblinger og URL-er med tilpassbar formatering (f.eks. blå tekst og understreking), som gjør det mulig å klikke på lenker til nettsteder, dokumenter eller andre ark. Disse funksjonene gjør xlsxwriter-rs egnet for å lage rike, interaktive rapporter og dashbord som kombinerer data, visuelle elementer og navigasjon. Alt innbakt innhold er fullt kompatibelt med Excels renderingsmotor og bevarer layoutintegriteten på tvers av plattformer.
Skriv URL og legg inn bilde
// 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")?;