1. Produkter
  2.   Regneark
  3.   Rust
  4.   umya-spreadsheet

umya-spreadsheet

 
 

Rent Rust-bibliotek til XLSX/XLSM-filer

Læs, skriv, stil og manipulér XLSX/XLSM-regneark uden eksterne afhængigheder.

Hvad er umya-spreadsheet?

umya-spreadsheet er et højtydende, rent Rust-bibliotek til læsning og skrivning af Excel-regnearksfiler i XLSX- og XLSM-formater. Designet til sikkerhed og effektivitet undgår det usikker kode og eksterne afhængigheder, hvilket gør det ideelt til skrivebordsapplikationer, server-side behandling og WebAssembly-miljøer. Biblioteket leverer et rent, idiomatisk Rust-API til adgang til celler, rækker, kolonner, stilarter, diagrammer og billeder, så udviklere kan bygge robuste regnearksværktøjer uden at være afhængige af Microsoft Office eller COM-interoperabilitet.

Med fuld support for lazy loading, adgangskodebeskyttelse og rig formatering bygger umya-spreadsheet broen mellem ydeevne og brugervenlighed. Det understøtter CSV-eksport, diagramgenerering, indlejring af billeder og områdeoperationer som flytning og kopiering. Projektet vedligeholdes aktivt, er veldokumenteret og testet, med fokus på korrekthed og kompatibilitet med moderne Excel-funktioner. Udviklere kan integrere det i CLI-værktøjer, web-backends eller skrivebordsapps ved hjælp af rammer som Tauri eller Axo.

Previous Next

Kom i gang med umya-spreadsheet

For at begynde at bruge umya-spreadsheet, tilføj den til din Cargo.toml med `umya-spreadsheet = "3.1.1"`. For WebAssembly-understøttelse, aktivér `js`-funktionen. Biblioteket er let på afhængigheder og kompilerer hurtigt. Når det er installeret, importér det via `extern crate umya_spreadsheet;` og begynd at læse eller skrive regneark. Du kan også udforske umya-spreadsheet GitHub for eksempler, tests og dokumentation. Det understøtter lazy loading for store filer og tilbyder robust fejlhåndtering.

Installer umya-spreadsheet via Cargo

[dependencies]
umya-spreadsheet = "3.1.1"

# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }

Læs & skriv XLSX/XLSM-filer

umya-spreadsheet leverer intuitive API'er til læsning og skrivning af XLSX- og XLMS-filer. Brug `reader::xlsx::read()` til at indlæse en projektmappe fra disk, eller `new_file()` til at oprette en tom. Skrivning er lige så enkelt: kald `writer::xlsx::write()` med projektmappen og destinationsstien. Biblioteket understøtter lazy loading via `lazy_read()` for forbedret ydeevne på store filer, og tillader password-beskyttet skrivning eller indstilling af adgangskoder efter oprettelse. Alle operationer er sikre, zero-copy hvor det er muligt, og undgår eksterne binære filer.

Hvordan læser og skriver man en XLSX-fil via Rust?

use std::path::Path;

// Read file
let path = Path::new("./input.xlsx");
let mut book = umya_spreadsheet::reader::xlsx::read(path).unwrap();

// Write file
let out_path = Path::new("./output.xlsx");
umya_spreadsheet::writer::xlsx::write(&book, out_path).unwrap();

Celleadgang & stilmanipulation

Adgang til og ændring af celleværdier er ligetil: brug `cell("A1")` eller `cell((1,1))` til læsning, og `cell_mut()` til skrivning. Stilarter håndteres via `style_mut()`, hvilket muliggør ændringer af baggrundsfarve, skrifttype, kanter og justering. Biblioteket eksponerer et rigt sæt af stil-egenskaber, mens det bevarer immutabilitetsgarantier, hvor det er muligt. Du kan også hente formaterede værdier, anvende betinget logik og batch-opdatere stilarter på tværs af områder. Dette gør det ideelt til at generere rapporter, dashboards eller dataeksport med ensartet formatering.

Hvordan ændrer man celleværdi og -stil via Rust?

let mut book = umya_spreadsheet::new_file();
book.sheet_by_name_mut("Sheet1")
    .unwrap()
    .cell_mut("A1")
    .set_value("Hello, Rust!");

let mut style = book.sheet_by_name_mut("Sheet1")
    .unwrap()
    .style_mut("A1");
style.set_background_color(umya_spreadsheet::Color::COLOR_RED);

Diagrammer & billedunderstøttelse

umua-spreadsheet understøtter oprettelse og redigering af diagrammer—herunder linje-, søjle- og arealdiagrammer—ved at definere serierækker og markører. Du kan indlejre billeder direkte i ark ved hjælp af `Image`-structen, med understøttelse af PNG og andre formater afhængigt af aktiverede funktioner. Diagrammer og billeder integreres problemfrit med cellekoordinater og tegnelag, hvilket muliggør dynamisk dashboard‑generering. Selvom nogle avancerede tegnefunktioner stadig er under udvikling, er kernefunktionaliteten produktionsklar og udvidelig.

Hvordan tilføjer man et linjediagram til et regneark via Rust?

let mut book = umya_spreadsheet::new_file();
let mut from_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
from_marker.set_coordinate("C1");
let mut to_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
to_marker.set_coordinate("D11");
let series = vec!["Sheet1!$A$1:$A$10", "Sheet1!$B$1:$B$10"];
let mut chart = umya_spreadsheet::structs::Chart::default();
chart.new_chart(
    umya_spreadsheet::structs::ChartType::LineChart,
    from_marker,
    to_marker,
    series,
);
book.sheet_by_name_mut("Sheet1")
    .unwrap()
    .add_chart(chart);

Områdeoperationer & adgangskodebeskyttelse

Udfør avancerede operationer som at flytte, kopiere og ændre størrelsen på områder ved hjælp af `move_range()`, hvilket muliggør dynamisk dataomorganisering. Biblioteket understøtter også adgangskodebeskyttede projektmapper: skriv filer med `write_with_password()` eller anvend adgangskoder på eksisterende filer via `set_password()`. Disse funktioner er afgørende for sikker datahåndtering i virksomhedsapplikationer eller i overensstemmelsesfølsomme miljøer. Kombineret med et nul‑afhængighedsdesign og WASM-kompatibilitet leverer umua-spreadsheet både fleksibilitet og sikkerhed.

Hvordan flytter man et område og beskytter en fil med adgangskode via Rust?

// Move range
let range = "A1:A3";
book.sheet_by_name_mut("Sheet1")
    .unwrap()
    .move_range(range, &10, &2);

// Password protection
umya_spreadsheet::writer::xlsx::write_with_password(
    &book,
    Path::new("./protected.xlsx"),
    "mypassword",
).unwrap();
 Dansk