1. Des produits
  2.   Tableur
  3.   Rust
  4.   xlsxwriter-rs

xlsxwriter-rs

 
 

Bibliothèque Rust pour la génération d'Excel XLSX

Créez des fichiers Excel XLSX entièrement compatibles avec formatage, cellules fusionnées, autofiltres et images via l'API Rust.

Qu'est-ce que xlsxwriter-rs ?

xlsxwriter-rs est une liaison Rust haute performance pour la bibliothèque C libxlsxwriter largement utilisée, permettant aux développeurs de générer des fichiers Excel XLSX entièrement compatibles directement depuis des applications Rust. Elle prend en charge le formatage complet d’Excel, y compris les polices, les couleurs, l’alignement, les bordures et les formats numériques, ainsi que des fonctionnalités avancées telles que les cellules fusionnées, les filtres automatiques, la validation des données et l’intégration d’images PNG/JPEG. Conçu pour la fiabilité et la rapidité, xlsxwriter-rs est idéal pour la génération de rapports côté serveur, les pipelines d’exportation de données et tout scénario nécessitant la création programmatique de fichiers Excel en Rust.

La bibliothèque exploite la sécurité mémoire de Rust et ses abstractions à coût nul pour fournir une API sûre et efficace de génération Excel sans nécessiter Microsoft Excel ni des dépendances externes comme COM. Elle s'intègre parfaitement à Cargo et prend en charge des drapeaux de fonctionnalités optionnels pour personnaliser le comportement, comme désactiver les sommes de contrôle MD5 ou utiliser zlib système. Avec son interface Rust propre et idiomatique ainsi que sa documentation complète, xlsxwriter-rs permet aux développeurs de créer des outils de génération Excel robustes et multiplateformes tout en conservant un contrôle total sur la structure et le contenu du fichier.

Previous Next

Premiers pas avec xlsxwriter-rs

Pour commencer à utiliser xlsxwriter-rs, ajoutez-le à votre Cargo.toml via cargo add xlsxwriter ou incluez manuellement [dependencies] avec xlsxwriter = "0.1". La bibliothèque nécessite LLVM et Clang pour la compilation bindgen. Sous Windows, installez Visual Studio et LLVM, puis définissez LIBCLANG_PATH sur le répertoire bin de LLVM. Après la configuration, clonez le dépôt, exécutez git submodule update --init --recursive pour récupérer la bibliothèque C, et compilez les exemples avec cargo run --example hello_spreadsheet. La documentation complète et les exemples sont disponibles sur le GitHub de xlsxwriter-rs.

Installer xlsxwriter-rs via Cargo

cargo add xlsxwriter

Prise en charge complète du formatage Excel

xlsxwriter-rs offre des capacités de formatage complètes, permettant aux développeurs de personnaliser les polices, les couleurs, les bordures, l'alignement et les formats numériques pour des cellules ou des plages individuelles. Vous pouvez appliquer le gras, l'italique, le soulignement, la taille de police et des couleurs personnalisées au texte, définir des couleurs de remplissage d'arrière-plan, définir les bordures des cellules avec différents styles (fin, moyen, épais) et contrôler l'alignement horizontal/vertical. Ce niveau de contrôle garantit que les fichiers Excel générés respectent les normes professionnelles de reporting. Le formatage est appliqué à l'aide de la structure Format, qui prend en charge le chaînage de méthodes pour une configuration intuitive. Cette fonctionnalité est essentielle pour créer des rapports, des tableaux de bord et des exportations de données visuellement distincts qui améliorent la lisibilité et l'expérience utilisateur.

Appliquer la couleur de police et l'alignement aux cellules

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

Cellules fusionnées et plages

La bibliothèque prend en charge la fusion de plages rectangulaires de cellules, ce qui est essentiel pour créer des en-têtes, des titres et des sections de données groupées dans les rapports Excel. En utilisant la méthode merge_range, vous pouvez couvrir plusieurs lignes et colonnes tout en appliquant le formatage à l’ensemble du bloc fusionné. Cela garantit une cohérence du style et de la mise en page dans les feuilles de calcul complexes. Les cellules fusionnées sont entièrement compatibles avec le moteur de rendu d’Excel et conservent le formatage tel que l’alignement du texte, les bordures et les couleurs d’arrière-plan. Cette fonctionnalité est particulièrement utile pour les états financiers, les tableaux de bord et les formulaires où le regroupement visuel améliore la compréhension des données et la qualité de la présentation.

Fusionner une plage avec un formatage personnalisé

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

Filtres automatiques et validation des données

xlsxwriter-rs permet la création programmatique de filtres automatiques et de règles de validation de données, permettant aux utilisateurs de trier, filtrer et valider les données directement dans Excel. Vous pouvez appliquer un filtre automatique à une plage de cellules en utilisant set_autofilter, et définir des listes déroulantes pour la saisie utilisateur via la validation de données. Cela prend en charge la validation basée sur des listes, les plages numériques, les dates et les formules personnalisées. Ces fonctionnalités améliorent l'interactivité et l'intégrité des données dans les feuilles de calcul, les rendant adaptées aux formulaires, aux modèles et à la saisie collaborative de données. Les fichiers XLSX générés conservent toutes leurs fonctionnalités lorsqu'ils sont ouverts dans Excel, LibreOffice ou Google Sheets, garantissant une large compatibilité.

Appliquer le filtre automatique et la validation des données

// 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"])
)?;

Intégrer des images et des hyperliens

Vous pouvez intégrer des images PNG et JPEG directement dans les feuilles de calcul Excel à l'aide de xlsxwriter-rs, en prenant en charge le positionnement, le redimensionnement et le redimensionnement proportionnel. Cela est idéal pour ajouter des logos, des graphiques ou des indicateurs visuels aux rapports. De plus, la bibliothèque prend en charge les hyperliens et les URL avec un formatage personnalisable (par exemple, texte bleu et soulignements), permettant des liens cliquables vers des sites web, des documents ou d’autres feuilles. Ces fonctionnalités rendent xlsxwriter-rs adapté à la création de rapports et de tableaux de bord riches et interactifs qui combinent données, visuels et navigation. Tout le contenu intégré est entièrement compatible avec le moteur de rendu d’Excel et préserve l’intégrité de la mise en page sur toutes les plateformes.

Écrire une URL et intégrer une image

// 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")?;
 Français