Slint Kit Documentation

Retour et progression

Barre de progression pour Slint

KitProgress · Slint Kit 0.3.0

Barre de progression déterminée exprimée par une fraction.

Barre de progression déterminée exprimée par une fraction.
Application native de l’exemple ci-dessous.

Essayer le composant

Télécharger le projet complet, le décompresser et lancer cargo run --locked dans son dossier. Rust 1.92+ ; Slint Kit 0.3.0 depuis crates.io. Vous pouvez aussi copier les quatre fichiers ci-dessous.

Avancez l’envoi par pas de 25 % ; Rust publie une progression bornée.

ui/app.slint

export { KitFormValidation, HtmlInputKind, NumberInputFormat, KitInputConstraints, KitValidationResult, KitValidityState } from "@kit/kit.slint";
// SPDX-License-Identifier: GPL-3.0-or-later
import { KitProgress, KitButton, KitTheme, KitThemes } from "@kit/kit.slint";
export component App inherits Window {
    title: "KitProgress example";
    preferred-width: 520px;
    preferred-height: 300px;
    max-width: 100000px;
    max-height: 100000px;
    background: root.theme.canvas;
    in-out property <KitTheme> theme: KitThemes.light;
    in property <int> percent;
    callback advance();
    VerticalLayout {
        padding: 24px;
        spacing: 16px;
        alignment: start;
        control := KitProgress { theme: root.theme; label: "Upload"; value: root.percent / 100; }
        KitButton { theme: root.theme; text: "Advance upload"; activated => { root.advance(); } }
        result := Text { text: root.percent + "% uploaded"; color: root.theme.text-primary; }
    }

}

src/main.rs

// SPDX-License-Identifier: GPL-3.0-or-later
use slint::ComponentHandle;

mod ui { slint::include_modules!(); }
fn main() -> Result<(), slint::PlatformError> {
    let app = ui::App::new()?;
    slint_kit::init_form_validation!(ui, app);
    let weak = app.as_weak();
    app.on_advance(move || { if let Some(app) = weak.upgrade() { app.set_percent((app.get_percent() + 25).min(100)); } });
    app.run()
}
Cargo.toml et build.rs

Cargo.toml

[package]
name = "slint-kit-progress-example"
version = "0.1.0"
edition = "2024"
rust-version = "1.92"
license = "GPL-3.0-or-later"
publish = false

[dependencies]
slint-kit = "=0.3.0"
slint = { version = "=1.18.1", default-features = false, features = ["std", "compat-1-18", "backend-winit", "renderer-skia", "accessibility"] }

[build-dependencies]
slint-kit-build = "=0.3.0"

[workspace]

build.rs

fn main() { slint_kit_build::compile("ui/app.slint").expect("compile component example"); }

Fichiers : Cargo.toml · build.rs · ui/app.slint · src/main.rs

Projetez l’avancement dans value entre 0 et 1 et fournissez un label contextualisé. Conservez les compteurs exacts et le calcul de la fraction dans le contrôleur.

bounded-value borne le rendu à l’intervalle et le pourcentage accessible est arrondi. Le composant n’anime pas une progression fictive et ne gère pas la tâche.

Voir le code source ↗

Choisir entre une option intégrée et une composition personnalisée

Options partagées

Composition visuelle

Le fichier ci-dessous produit la capture. Pour les composants pilotés par un contrôleur, il montre l’état affiché sans fournir le branchement Rust. Créer un projet.

Afficher le fichier de la capture
Barre de progression déterminée exprimée par une fraction.
Capture native du même exemple, moteur Skia.
// Public label overrides localize this fixture; toolkit/host defaults keep their language.
// SPDX-License-Identifier: GPL-3.0-or-later
import { KitProgress, KitTheme, KitThemes } from "@kit/kit.slint";

export component Example inherits Window {
    title: "KitProgress — exemple";
    preferred-width: 420px;
    preferred-height: 180px;
    max-width: 100000px;
    max-height: 100000px;
    background: root.theme.canvas;
    in-out property <KitTheme> theme: KitThemes.light;
    in-out property <string> status;
    VerticalLayout {
        padding: 24px; spacing: 16px; alignment: start;
        Text { text: "Progression"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitProgress { theme: root.theme; label: "Téléversement des documents · 65 %"; value: 0.65; }
        if root.status != "": Text { text: root.status; color: root.theme.text-secondary; font-size: 12px * root.theme.text-scale; wrap: word-wrap; }
    }
}

Télécharger cet exemple

API publique

Hérite de VerticalLayout.

Propriétés

Nom Type Sens
theme KitTheme in
value float in
label string in
bounded-value float out

Voir aussi