Nombres et montants

Compteur numérique pour Slint

KitNumberStepper · Slint Kit 0.3.1

Saisie décimale avec demandes d’incrémentation et de décrémentation.

Lancer l’aperçu

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.

Modifiez le décimal ou utilisez les boutons de pas. Rust applique un pas exact de un entre 0 et 100 puis accepte le résultat.

ui/app.slint

export { KitFormValidation, HtmlInputKind, NumberInputFormat, KitInputConstraints, KitValidationResult, KitValidityState } from "@kit/kit.slint";
import { KitNumberStepper, KitButton, KitThemes, ValidationPresentation, StepDirection } from "@kit/kit.slint";
export component App inherits Window {
    title: "Quantity"; preferred-width: 520px; preferred-height: 320px;
    max-width: 100000px; max-height: 100000px; background: KitThemes.light.canvas;
    in-out property <string> draft; in property <string> error; in property <string> accepted;
    callback edited(string); callback commit(); callback blurred(); callback cancel();
    callback step(StepDirection);
    VerticalLayout {
        padding: 24px; spacing: 16px; alignment: start;
        control := KitNumberStepper {
            required: true;
            label: "Quantity"; text <=> root.draft; error: root.error;
            validation: root.error != "" ? ValidationPresentation.invalid : ValidationPresentation.pristine;
            placeholder: "12";
            edited(value) => { root.edited(value); }
            commit-requested(value) => { root.commit(); }
            cancelled => { root.cancel(); }
            focus-observed(focused) => { if (!focused) { root.blurred(); } }
            step-requested(direction) => { root.step(direction); }
        }
        KitButton { text: "Accept"; activated => { root.commit(); } }
        Text { text: "Accepted: " + root.accepted; color: KitThemes.light.text-primary; wrap: word-wrap; }
    }
}

src/main.rs

use slint::ComponentHandle;
use slint_kit::*;
mod ui {
    slint::include_modules!();
}
use ui::App;
type Value = DecimalValue;
fn parse(text: &str) -> DraftValue<Value> {
    DecimalRules {
        locale: NumberLocale::EnCa,
        scale: DecimalScale::new(2).unwrap(),
        sign: SignPolicy::NonNegative,
        bounds: None,
    }
    .parse(text)
}
fn format(value: &Value) -> String {
    value.to_string()
}
fn main() -> Result<(), slint::PlatformError> {
    let app = App::new()?;
    slint_kit::init_form_validation!(ui, app);
    let initial = DecimalValue::from_integer(12);
    app.set_accepted(format(&initial).into());
    let weak = app.as_weak();
    let field = FieldBinding::<Value, ()>::new(
        Some(initial),
        Ownership::Local,
        CommitPolicy::OnBlur,
        AbsencePolicy::Required,
        parse,
        format,
        |_| String::new(),
        move |view| {
            if let Some(app) = weak.upgrade() {
                app.set_draft(view.draft.into());
                app.set_error(view.error.into());
            }
        },
    );
    field.set_html_constraints(slint_kit::HtmlConstraints {
        kind: slint_kit::HtmlInputKind::Number, required: true,
        step: Some("1".into()),
        ..Default::default()
    });
    let weak = app.as_weak();
    field.on_intent(move |intent| {
        if let Some(app) = weak.upgrade() {
            if let FieldIntent::Commit(value) = intent {
                app.set_accepted(format(&value).into());
            }
        }
    });
    let binding = field.clone();
    app.on_edited(move |text| {
        let _ = binding.edited(&text);
    });
    let binding = field.clone();
    app.on_commit(move || {
        let _ = binding.commit(CommitTrigger::Submit);
    });
    let binding = field.clone();
    app.on_blurred(move || {
        let _ = binding.commit(CommitTrigger::Blur);
    });
    let binding = field.clone();
    app.on_cancel(move || binding.cancel());
    let binding = field.clone();
    app.on_step(move |direction| {
        let Some(value) = binding.accepted() else {
            return;
        };
        let next = DecimalStep::new(DecimalValue::from_integer(1))
            .unwrap()
            .apply(
                value,
                if direction == ui::StepDirection::Increment {
                    StepDirection::Increment
                } else {
                    StepDirection::Decrement
                },
                NumericBounds::new(DecimalValue::ZERO, DecimalValue::from_integer(100)).unwrap(),
            );
        if let Ok(next) = next {
            let _ = binding.edited(&next.to_string());
            let _ = binding.commit(CommitTrigger::Explicit);
        }
    });
    app.run()
}

[package]
name = "slint-kit-number-stepper-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]

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

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

Reliez step-requested à DecimalStep et NumericBounds. L’exemple progresse par pas de 1 entre 0 et 100.

Rust applique chaque pas au DecimalValue accepté. La saisie texte utilise le même parseur et la même validation que les autres champs numériques.

Voir le code source ↗

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

Options partagées

• label — propriété intégrée ; exemple de composition personnalisé
• description — propriété intégrée ; exemple de composition personnalisé
• error — propriété intégrée ; exemple de composition personnalisé

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

// Public label overrides localize this fixture; toolkit/host defaults keep their language.
// SPDX-License-Identifier: GPL-3.0-or-later
import { KitNumberStepper, KitTheme, KitThemes } from "@kit/kit.slint";

export component Example inherits Window {
    title: "KitNumberStepper — 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: "Champ numérique à incréments"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitNumberStepper { decrement-label: "Diminuer la valeur"; increment-label: "Augmenter la valeur"; theme: root.theme; label: "Invités"; text: "3"; step-requested(direction) => { root.status = "Incrément demandé ; valider dans Rust"; }; edited(value) => { root.status = "Brouillon : " + value; } }
        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 KitField.

Propriétés

Types et variantes

Signaux

• invalid()
• edited(string)
• commit-requested(string)
• cancelled()
• focus-observed(bool)
• step-requested(StepDirection)

Fonctions

• check-validity() → bool
• report-validity() → bool
• set-custom-validity(message: string)
• reset-validation()
• take-focus()

Voir aussi

• Champ entier
• Champ décimal
• Curseur