Boutons et actions

Bouton de formulaire pour Slint

KitFormButton · Slint Kit 0.3.1

Bouton qui transmet une intention de formulaire typée.

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 nom puis cliquez sur Save changes : Rust accepte un nom non vide et l’affiche.

ui/app.slint

export { KitFormValidation, HtmlInputKind, NumberInputFormat, KitInputConstraints, KitValidationResult, KitValidityState } from "@kit/kit.slint";
// SPDX-License-Identifier: GPL-3.0-or-later
import { KitFormButton, KitTextField, KitThemes, FormAction } from "@kit/kit.slint";
export { FormAction }
export component App inherits Window {
    title: "KitFormButton";
    preferred-width: 460px;
    preferred-height: 260px;
    max-width: 100000px;
    max-height: 100000px;
    background: KitThemes.light.canvas;
    in-out property <string> draft: "Field notes";
    in property <string> result: "Edit the draft, then use the action.";
    callback form-action(FormAction, string);
    VerticalLayout {
        padding: 24px; spacing: 16px; alignment: start;
        KitTextField { label: "Project name"; text <=> root.draft; }
        action := KitFormButton { text: "Save changes"; form-action(action) => { root.form-action(action, root.draft); } }
        Text { text: root.result; color: KitThemes.light.text-primary; wrap: word-wrap; }
    }
}

src/main.rs

// SPDX-License-Identifier: GPL-3.0-or-later
use slint::ComponentHandle;
slint::include_modules!();

struct ProjectName(String);
impl ProjectName {
    fn parse(draft: &str) -> Option<Self> {
        let name = draft.trim();
        (!name.is_empty()).then(|| Self(name.into()))
    }
}

fn main() -> Result<(), slint::PlatformError> {
    let app = App::new()?;
    slint_kit::init_form_validation!(self, app);
    let weak = app.as_weak();
    app.on_form_action(move |action, draft| {
        if let Some(app) = weak.upgrade() {
            match action {
                FormAction::Reset => {
                    app.set_draft("Field notes".into());
                    app.set_result("Draft reset to Field notes".into());
                }
                FormAction::Submit => {
                    let result = match ProjectName::parse(&draft) {
                        Some(name) => format!("Accepted in Rust: {}", name.0),
                        None => "Enter a project name before submitting".into(),
                    };
                    app.set_result(result.into());
                }
            }
        }
    });
    app.run()
}

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

Choisissez FormAction.submit ou .reset, puis traitez form-action(action) dans Rust. L’exemple transmet le brouillon courant à ce callback.

L’activation émet l’intention courante sans soumettre ni réinitialiser les champs elle-même. Les états busy et disabled viennent de KitButton.

Voir le code source ↗

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 { KitFormButton, KitTheme, KitThemes } from "@kit/kit.slint";

export component Example inherits Window {
    title: "KitFormButton — exemple";
    preferred-width: 360px;
    preferred-height: 160px;
    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: "Bouton de formulaire"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitFormButton { theme: root.theme; text: "Enregistrer les modifications"; activated => { root.status = "Action demandée"; } }
        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 KitButton.

Propriétés

Types et variantes

Signaux

• validation-requested() → bool
• form-action(FormAction)

Voir aussi

• Bouton d’envoi
• Bouton de réinitialisation