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

umya-spreadsheet

 
 

Rent Rust-bibliotek for XLSX/XLSM-filer

Les, skriv, stil og manipuler XLSX/XLSM-regneark med null eksterne avhengigheter.

Hva er umya-spreadsheet?

umya-spreadsheet er et høyytelses, rent Rust-bibliotek for lesing og skriving av Excel-regnearkfiler i XLSX- og XLSM-formatene. Designet for sikkerhet og effektivitet, unngår det usikker kode og eksterne avhengigheter, noe som gjør det ideelt for skrivebordsapplikasjoner, server‑side prosessering og WebAssembly-miljøer. Biblioteket tilbyr et rent, idiomatisk Rust‑API for tilgang til celler, rader, kolonner, stiler, diagrammer og bilder, og gjør det mulig for utviklere å bygge robuste regnearkverktøy uten å måtte stole på Microsoft Office eller COM‑interop.

Med full støtte for lazy loading, passordbeskyttelse og rik formatering, bygger umya-spreadsheet bro mellom ytelse og brukervennlighet. Det støtter CSV‑eksport, diagramgenerering, innbygging av bilder og områdeoperasjoner som flytting og kopiering. Prosjektet vedlikeholdes aktivt, er godt dokumentert og testet, med fokus på korrekthet og kompatibilitet med moderne Excel‑funksjoner. Utviklere kan integrere det i CLI‑verktøy, web‑backend eller skrivebords‑apper ved hjelp av rammeverk som Tauri eller Axo.

Previous Next

Kom i gang med umya-spreadsheet

Begynn å bruke umya-spreadsheet ved å legge den til i Cargo.toml med `umya-spreadsheet = "3.1.1"`. For WebAssembly-støtte, aktiver `js`-funksjonen. Biblioteket er lett på avhengigheter og kompilerer raskt. Når det er installert, importer det via `extern crate umya_spreadsheet;` og start med å lese eller skrive regneark. Du kan også utforske umya-spreadsheet GitHub for eksempler, tester og dokumentasjon. Det støtter lazy loading for store filer og tilbyr robust feilhåndtering.

Installer umya-spreadsheet via Cargo

[dependencies]
umya-spreadsheet = "3.1.1"

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

Lese og skrive XLSX/XLSM-filer

umya-spreadsheet tilbyr intuitive API-er for lesing og skriving av XLSX- og XLMS-filer. Bruk `reader::xlsx::read()` for å laste inn en arbeidsbok fra disk, eller `new_file()` for å opprette en tom. Skriving er like enkelt: kall `writer::xlsx::write()` med arbeidsboken og målbanen. Biblioteket støtter lazy loading via `lazy_read()` for forbedret ytelse på store filer, og tillater passordbeskyttet skriving eller å sette passord etter opprettelse. Alle operasjoner er sikre, nullkopiering der det er mulig, og unngår eksterne binærfiler.

Hvordan lese og skrive 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();

Celletilgang og stilmanipulering

Å få tilgang til og endre celleverdier er enkelt: bruk `cell("A1")` eller `cell((1,1))` for lesing, og `cell_mut()` for skriving. Stiler håndteres via `style_mut()`, som tillater endring av bakgrunnsfarge, skrifttype, kanter og justering. Biblioteket eksponerer et rikt sett med stil-egenskaper samtidig som det opprettholder immutabilitetsgarantier der det er mulig. Du kan også hente formaterte verdier, anvende betinget logikk, og oppdatere stiler i batch over områder. Dette gjør det ideelt for å generere rapporter, dashbord eller dataeksport med konsistent formatering.

Hvordan endre celleverdi 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);

Diagram- og bildestøtte

umya-spreadsheet støtter oppretting og redigering av diagrammer—inkludert linje-, stolpe- og områdediagrammer—ved å definere serieranger og markører. Du kan bygge inn bilder direkte i ark ved å bruke `Image`-strukturen, med støtte for PNG og andre formater avhengig av hvilke funksjoner som er aktivert. Diagrammer og bilder integreres sømløst med cellekoordinater og tegnelag, noe som muliggjør dynamisk dashbordgenerering. Selv om noen avanserte tegnefunksjoner fortsatt er under utvikling, er kjernefunksjonaliteten produksjonsklar og utvidbar.

Hvordan legge til et linjediagram i 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ådeoperasjoner og passordbeskyttelse

Utfør avanserte operasjoner som å flytte, kopiere og endre størrelse på områder ved hjelp av `move_range()`, noe som muliggjør dynamisk dataorganisering. Biblioteket støtter også passordbeskyttede arbeidsbøker: skriv filer med `write_with_password()` eller legg til passord på eksisterende filer via `set_password()`. Disse funksjonene er kritiske for sikker databehandling i bedrifts- eller samsvarsfølsomme applikasjoner. Kombinert med null‑avhengighetsdesign og WASM-kompatibilitet, leverer umya-spreadsheet både fleksibilitet og sikkerhet.

Hvordan flytte et område og beskytte en fil med passord 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();
 Norsk