1. Termékek
  2.   Táblázat
  3.   Rust
  4.   umya-spreadsheet

umya-spreadsheet

 
 

Tiszta Rust könyvtár XLSX/XLSM fájlokhoz

XLSX/XLSM táblázatok olvasása, írása, stílusozása és manipulálása nulla külső függőséggel.

Mi az umya-spreadsheet?

az umya-spreadsheet egy nagy teljesítményű, tiszta Rust könyvtár az Excel táblázatfájlok (XLSX és XLSM formátum) olvasásához és írásához. Biztonságra és hatékonyságra tervezve kerülőleg a nem biztonságos kódot és külső függőségeket, így ideális asztali alkalmazásokhoz, szerveroldali feldolgozáshoz és WebAssembly környezetekhez. A könyvtár tiszta, idiomatikus Rust API-t biztosít a cellák, sorok, oszlopok, stílusok, diagramok és képek eléréséhez, lehetővé téve a fejlesztők számára, hogy robusztus táblázatkezelő eszközöket építsenek anélkül, hogy a Microsoft Office vagy a COM interopra támaszkodnának.

Teljes körű támogatással a lusta betöltéshez, jelszóvédelemhez és gazdag formázáshoz, az umya-spreadsheet áthidalja a teljesítmény és a használhatóság közötti szakadékot. Támogatja a CSV exportot, diagramgenerálást, képbeágyazást és a tartományműveleteket, mint a mozgatás és másolás. A projekt aktívan karbantartott, jól dokumentált és tesztelt, a helyességre és a modern Excel funkciókkal való kompatibilitásra összpontosítva. A fejlesztők integrálhatják CLI eszközökbe, web backendekbe vagy asztali alkalmazásokba olyan keretrendszerekkel, mint a Tauri vagy az Axo.

Previous Next

Az umya-spreadsheet használatának megkezdése

Az umya-spreadsheet használatának megkezdéséhez add hozzá a Cargo.toml-hoz a következővel: `umya-spreadsheet = "3.1.1"`. A WebAssembly támogatáshoz engedélyezd a `js` funkciót. A könyvtár könnyű függőségekkel rendelkezik, és gyorsan fordul. A telepítés után importáld a `extern crate umya_spreadsheet;` segítségével, és kezdj el táblázatokat olvasni vagy írni. Továbbá felfedezheted a umya-spreadsheet GitHub oldalt példák, tesztek és dokumentáció miatt. Támogatja a nagy fájlok lazy betöltését, és robusztus hibakezelést kínál.

Umya-spreadsheet telepítése Cargo-n keresztül

[dependencies]
umya-spreadsheet = "3.1.1"

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

XLSX/XLSM fájlok olvasása és írása

az umya-spreadsheet intuitív API-kat biztosít az XLSX és XLMS fájlok olvasásához és írásához. Használja a `reader::xlsx::read()`-t egy munkafüzet betöltéséhez a lemezről, vagy a `new_file()`-t egy üres létrehozásához. Az írás ugyanolyan egyszerű: hívja a `writer::xlsx::write()`-t a munkafüzettel és a célúttal. A könyvtár támogatja a lusta betöltést a `lazy_read()` segítségével a nagy fájlok teljesítményének javítása érdekében, és lehetővé teszi a jelszóval védett írást vagy a jelszavak beállítását a létrehozás után. Minden művelet biztonságos, ahol lehetséges, nulla másolással, és elkerüli a külső binárisok használatát.

Hogyan olvassunk és írjunk XLSX fájlt Rust segítségével?

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

Cellák elérése és stílus manipulációja

A cellák értékeinek elérése és módosítása egyszerű: használja a `cell("A1")` vagy `cell((1,1))` függvényeket az olvasáshoz, és a `cell_mut()`-t az íráshoz. A stílusok a `style_mut()` segítségével kezelhetők, lehetővé téve a háttérszín, betűtípus, szegélyek és igazítás módosítását. A könyvtár gazdag stílus tulajdonságkészletet kínál, miközben ahol lehetséges, az immutabilitási garanciákat fenntartja. Lekérdezheti a formázott értékeket, alkalmazhat feltételes logikát, és kötegelt módon frissítheti a stílusokat tartományokban. Ez ideálissá teszi jelentések, műszerfalak vagy adatexportok generálására, egységes formázással.

Hogyan módosítsuk a cella értékét és stílusát Rust segítségével?

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

Diagramok és képek támogatása

az umya-spreadsheet támogatja diagramok létrehozását és szerkesztését—beleértve a vonal-, oszlop- és területdiagramokat—a sorozat tartományok és jelölők meghatározásával. Képeket ágyazhatsz be közvetlenül a munkalapokba az `Image` struktúra használatával, PNG és egyéb formátumok támogatásával, a bekapcsolt funkcióktól függően. A diagramok és képek zökkenőmentesen integrálódnak a cellakoordinátákkal és a rajzrétegekkel, lehetővé téve a dinamikus műszerfal generálását. Bár néhány fejlett rajzfunkció még fejlődés alatt áll, a fő funkciók termelésre készek és bővíthetőek.

Hogyan adjunk hozzá vonaldiagramot egy táblázathoz Rust segítségével?

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

Tartomány műveletek és jelszóvédelem

Végrehajthatsz fejlett műveleteket, például tartományok áthelyezését, másolását és átméretezését a `move_range()` használatával, lehetővé téve a dinamikus adatújraszervezést. A könyvtár támogatja a jelszóval védett munkafüzeteket is: fájlok írása `write_with_password()`-val, vagy jelszavak alkalmazása meglévő fájlokra a `set_password()` segítségével. Ezek a funkciók kritikusak a vállalati vagy megfelelőségi érzékeny alkalmazásokban a biztonságos adatkezeléshez. A null függőségi tervezés és a WASM kompatibilitás kombinációjával az umya-spreadsheet rugalmas és biztonságos megoldást nyújt.

Hogyan mozgassunk egy tartományt és védjünk egy fájlt jelszóval Rust segítségével?

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