1. Tuotteet
  2.   Laskentataulukko
  3.   Rust
  4.   umya-spreadsheet

umya-spreadsheet

 
 

Puhtaan Rustin kirjasto XLSX/XLSM -tiedostoja varten

Lue, kirjoita, tyylittele ja muokkaa XLSX/XLSM -taulukoita ilman ulkoisia riippuvuuksia.

Mikä on umya-spreadsheet?

umya-spreadsheet on korkean suorituskyvyn, puhdas Rust-kirjasto Excel-taulukko-tiedostojen lukemiseen ja kirjoittamiseen XLSX- ja XLSM-muodoissa. Suunniteltu turvallisuutta ja tehokkuutta varten, se välttää epävarmaa koodia ja ulkoisia riippuvuuksia, mikä tekee siitä ihanteellisen työpöytäsovelluksiin, palvelinpuolen käsittelyyn ja WebAssembly-ympäristöihin. Kirjasto tarjoaa selkeän, idiomaatin Rust-API:n solujen, rivien, sarakkeiden, tyylien, kaavioiden ja kuvien käyttämiseen, mahdollistaen kehittäjien rakentaa vankkoja taulukko-työkaluja ilman Microsoft Officen tai COM-interoperabiliteetin käyttöä.

Tarjoten täyden tuen laiskaan lataukseen, salasanalla suojaukseen ja monipuoliseen muotoiluun, umya-spreadsheet sulkee kuilun suorituskyvyn ja käytettävyyden välillä. Se tukee CSV-vientiä, kaavioiden luomista, kuvien upottamista ja alueoperaatioita kuten siirtämistä ja kopiointia. Projekti on aktiivisesti ylläpidetty, hyvin dokumentoitu ja testattu, keskittyen oikeellisuuteen ja yhteensopivuuteen nykyaikaisten Excel-ominaisuuksien kanssa. Kehittäjät voivat integroida sen CLI-työkaluihin, web-taustajärjestelmiin tai työpöytäsovelluksiin käyttäen kehyksiä kuten Tauri tai Axo.

Previous Next

Umya-spreadsheetin aloittaminen

Alkaaksesi käyttää umya-spreadsheetia, lisää se Cargo.toml-tiedostoosi seuraavasti `umya-spreadsheet = "3.1.1"`. WebAssembly-tukea varten ota käyttöön `js`-ominaisuus. Kirjasto on kevyiden riippuvuuksien kanssa ja kääntyy nopeasti. Kun se on asennettu, tuo se komennolla `extern crate umya_spreadsheet;` ja aloita taulukoiden lukeminen tai kirjoittaminen. Voit myös tutustua umya-spreadsheet GitHubiin esimerkkien, testien ja dokumentaation osalta. Se tukee laiskaa latausta suurille tiedostoille ja tarjoaa vankkaa virheenkäsittelyä.

Asenna umya-spreadsheet Cargo:n avulla

[dependencies]
umya-spreadsheet = "3.1.1"

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

XLSX/XLSM-tiedostojen lukeminen ja kirjoittaminen

umya-spreadsheet tarjoaa intuitiivisia API-rajapintoja XLSX- ja XLMS-tiedostojen lukemiseen ja kirjoittamiseen. Käytä `reader::xlsx::read()` ladataksesi työkirjan levyltä tai `new_file()` luodaksesi tyhjän. Kirjoittaminen on yhtä yksinkertaista: kutsu `writer::xlsx::write()` työkirjan ja kohdepolun kanssa. Kirjasto tukee laiskaa latausta `lazy_read()`-menetelmällä parempaan suorituskykyyn suurissa tiedostoissa, ja mahdollistaa salasanalla suojatun kirjoittamisen tai salasanojen asettamisen luomisen jälkeen. Kaikki toiminnot ovat turvallisia, nollakopioita mahdollisuuksien mukaan, ja välttävät ulkoisia binääritiedostoja.

Kuinka lukea ja kirjoittaa XLSX-tiedosto Rustin avulla?

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

Solujen käyttö ja tyylien muokkaus

Soluarvojen hakeminen ja muokkaaminen on yksinkertaista: käytä `cell("A1")` tai `cell((1,1))` lukemiseen ja `cell_mut()` kirjoittamiseen. Tyylejä hallitaan `style_mut()`-menetelmällä, mikä mahdollistaa taustavärin, fontin, reunojen ja kohdistuksen muutokset. Kirjasto tarjoaa laajan valikoiman tyyppiominaisuuksia säilyttäen muuttumattomuuslupaukset mahdollisuuksien mukaan. Voit myös hakea muotoiltuja arvoja, soveltaa ehdollista logiikkaa ja päivittää tyylejä erissä alueiden yli. Tämä tekee siitä ihanteellisen raporttien, hallintapaneelien tai tietojen viennin luomiseen yhtenäisellä muotoilulla.

Kuinka muokata solun arvoa ja tyyliä Rustin avulla?

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

Kaavioiden ja kuvien tuki

umua-spreadsheet tukee kaavioiden luomista ja muokkaamista — mukaan lukien viiva-, palkki- ja aluekaaviot — määrittelemällä sarjan alueet ja merkinnät. Voit upottaa kuvia suoraan taulukoihin käyttämällä `Image`-rakennetta, ja se tukee PNG‑tiedostoja sekä muita formaatteja riippuen käytössä olevista ominaisuuksista. Kaaviot ja kuvat integroituvat saumattomasti solukoordinaatteihin ja piirroskerroksiin, mikä mahdollistaa dynaamisen hallintapaneelin luomisen. Vaikka jotkut kehittyneet piirto-ominaisuudet ovat vielä kehittymässä, ydintoiminnallisuus on tuotantovalmiina ja laajennettavissa.

Kuinka lisätä viivakaavio taulukkoon Rustin avulla?

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

Alueoperaatiot ja salasanansuoja

Toteuta edistyneitä toimintoja, kuten alueiden siirtämistä, kopiointia ja koon muuttamista käyttäen `move_range()`, mikä mahdollistaa dynaamisen tietojen uudelleenjärjestelyn. Kirjasto tukee myös salasanasuojattuja työkirjoja: kirjoita tiedostoja `write_with_password()`-funktiolla tai lisää salasanoja olemassa oleviin tiedostoihin `set_password()`-menetelmällä. Nämä ominaisuudet ovat kriittisiä turvalliselle tietojen käsittelylle yritys- tai säädösten vaativissa sovelluksissa. Yhdistettynä nollariippuvuuksiseen suunnitteluun ja WASM-yhteensopivuuteen, umua-spreadsheet tarjoaa sekä joustavuutta että turvallisuutta.

Kuinka siirtää alue ja suojata tiedosto salasanalla Rustin avulla?

// 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();
 Suomen