
xlsxwriter-rs
Rust-bibliotek til generering af Excel XLSX
Opret fuldt kompatible Excel XLSX-filer med formatering, sammensatte celler, autofiltre og billeder via Rust API.
Hvad er xlsxwriter-rs?
xlsxwriter-rs er en højtydende Rust-binding til det udbredte libxlsxwriter C-bibliotek, som gør det muligt for udviklere at generere fuldt kompatible Excel XLSX-filer direkte fra Rust-applikationer. Det understøtter omfattende Excel-formatering, herunder skrifttyper, farver, justering, kanter og talformater, samt avancerede funktioner som flettede celler, autofilter, datavalidering og indlejrede PNG/JPEG-billeder. Designet til pålidelighed og hastighed er xlsxwriter-rs ideel til server‑side rapportgenerering, data‑eksport pipelines og enhver situation, der kræver programmatisk oprettelse af Excel‑filer i Rust.
Biblioteket udnytter Rusts hukommelsessikkerhed og nul‑omkostningsabstraktioner for at levere et sikkert og effektivt API til Excel‑generering uden at kræve Microsoft Excel eller eksterne afhængigheder som COM. Det integreres problemfrit med Cargo og understøtter valgfrie funktionsflag til tilpasning af adfærd, såsom at deaktivere MD5‑kontrolsummer eller bruge system‑zlib. Med sit rene, idiomatiske Rust‑interface og omfattende dokumentation giver xlsxwriter-rs udviklere mulighed for at bygge robuste, tværplatforms Excel‑genereringsværktøjer, mens de bevarer fuld kontrol over filstruktur og indhold.
Kom i gang med xlsxwriter-rs
Begynd at bruge xlsxwriter-rs ved at tilføje den til din Cargo.toml via cargo add xlsxwriter eller manuelt inkludere [dependencies] med xlsxwriter = "0.1". Biblioteket kræver LLVM og Clang til bindgen-kompilering. Til Windows skal du installere Visual Studio og LLVM, og derefter sætte LIBCLANG_PATH til LLVM bin-mappen. Efter opsætning skal du klone repository'en, køre git submodule update --init --recursive for at hente C-biblioteket, og bygge eksempler med cargo run --example hello_spreadsheet. Fuld dokumentation og eksempler er tilgængelige på xlsxwriter-rs GitHub.
Installer xlsxwriter-rs via Cargo
cargo add xlsxwriterFuld understøttelse af Excel-formatering
xlsxwriter-rs leverer omfattende formateringsmuligheder, der gør det muligt for udviklere at tilpasse skrifttyper, farver, kanter, justering og talformater for individuelle celler eller områder. Du kan anvende fed, kursiv, understregning, skriftstørrelse og brugerdefinerede farver på tekst, indstille baggrundsfarver, definere cellekanter med forskellige stilarter (tynd, medium, tyk) og kontrollere vandret/lodret justering. Dette niveau af kontrol sikrer, at genererede Excel-filer matcher professionelle rapporteringsstandarder. Formatering anvendes ved hjælp af Format-strukturen, som understøtter metodekædning for intuitiv konfiguration. Denne funktion er essentiel for at skabe visuelt særprægede rapporter, dashboards og dataeksport, der forbedrer læsbarhed og brugeroplevelse.
Anvend skrifttypefarve 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)
)
)?;Flettede celler og områder
Biblioteket understøtter at sammenlægge rektangulære celleområder, hvilket er kritisk for at oprette overskrifter, titler og grupperede datasektioner i Excel-rapporter. Ved at bruge merge_range-metoden kan du spænde over flere rækker og kolonner, mens du anvender formatering på hele den sammenlagte blok. Dette sikrer ensartet styling og layout på tværs af komplekse regneark. Sammenlagte celler er fuldt kompatible med Excels renderingsmotor og bevarer formatering såsom tekstjustering, kanter og baggrundsfarver. Denne funktion er især nyttig for regnskaber, dashboards og formularer, hvor visuel gruppering forbedrer dataforståelse og præsentationskvalitet.
Flet et område med brugerdefineret 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 og datavalidering
xlsxwriter-rs muliggør programmatisk oprettelse af autofilter og datavalideringsregler, så brugere kan sortere, filtrere og validere data direkte i Excel. Du kan anvende et autofilter på et celleområde ved hjælp af set_autofilter, og definere rulleliste‑valg for brugerinput via datavalidering. Dette understøtter listebaseret validering, numeriske intervaller, datoer og brugerdefinerede formler. Disse funktioner forbedrer interaktivitet og dataintegritet i regneark, hvilket gør dem velegnede til formularer, skabeloner og samarbejdsbaseret dataindtastning. De genererede XLSX‑filer bevarer fuld funktionalitet, når de åbnes i Excel, LibreOffice eller Google Sheets, hvilket sikrer bred kompatibilitet.
Anvend 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"])
)?;Indlejr billeder og hyperlinks
Du kan indlejre PNG- og JPEG-billeder direkte i Excel-regneark ved hjælp af xlsxwriter-rs, som understøtter placering, størrelsesjustering og skalering. Dette er ideelt til at tilføje logoer, diagrammer eller visuelle indikatorer til rapporter. Derudover understøtter biblioteket hyperlinks og URL'er med tilpasselig formatering (f.eks. blå tekst og understregning), hvilket muliggør klikbare links til websider, dokumenter eller andre ark. Disse funktioner gør xlsxwriter-rs egnet til at skabe rige, interaktive rapporter og dashboards, der kombinerer data, visuelle elementer og navigation. Alt indlejret indhold er fuldt kompatibelt med Excels renderingsmotor og bevarer layoutintegriteten på tværs af platforme.
Skriv URL og indlejr billede
// 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")?;