Slint Kit Documentation

Retour et progression

Alerte pour Slint

KitAlert · Slint Kit 0.3.0

Message contextualisé de résultat, d’information ou d’erreur.

Message contextualisé de résultat, d’information ou d’erreur.
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.

Fermez l’alerte, puis affichez-la à nouveau. Rust retire et rétablit sa vue.

ui/app.slint

export { KitFormValidation, HtmlInputKind, NumberInputFormat, KitInputConstraints, KitValidationResult, KitValidityState } from "@kit/kit.slint";
// SPDX-License-Identifier: GPL-3.0-or-later
import { KitAlert, KitButton, AlertSeverity, KitTheme, KitThemes } from "@kit/kit.slint";
export component App inherits Window {
    title: "KitAlert example";
    preferred-width: 520px;
    preferred-height: 280px;
    max-width: 100000px;
    max-height: 100000px;
    background: root.theme.canvas;
    in-out property <KitTheme> theme: KitThemes.light;
    in property <bool> showing: true;
    callback dismiss();
    callback show();
    VerticalLayout {
        padding: 24px;
        spacing: 16px;
        alignment: start;
        if root.showing: control := KitAlert { theme: root.theme; severity: AlertSeverity.success; title: "Changes saved"; message: "Your team can read the updated project."; dismissible: true; dismissed => { root.dismiss(); } }
        KitButton { theme: root.theme; text: "Show alert"; activated => { root.show(); } }
        result := Text { text: root.showing ? "Alert visible" : "Alert dismissed"; 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_dismiss(move || { if let Some(app) = weak.upgrade() { app.set_showing(false); } });
    let weak = app.as_weak();
    app.on_show(move || { if let Some(app) = weak.upgrade() { app.set_showing(true); } });
    app.run()
}

Cargo.toml et build.rs

Cargo.toml

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

Définissez severity: AlertSeverity.information, .success, .warning ou .error, avec un titre explicite. Activez dismissible et traitez dismissed pour retirer le message dans l’état propriétaire.

Le composant ne se ferme pas lui-même. Le rôle accessible utilise une annonce polie, ou assertive pour une erreur, selon la prise en charge réelle du backend.

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
Message contextualisé de résultat, d’information ou d’erreur.
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 { AlertSeverity, KitAlert, KitTheme, KitThemes } from "@kit/kit.slint";

export component Example inherits Window {
    title: "KitAlert — exemple";
    preferred-width: 480px;
    preferred-height: 220px;
    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: "Alerte"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitAlert { theme: root.theme; severity: AlertSeverity.success; title: "Modifications enregistrées"; message: "Votre équipe peut maintenant consulter le projet mis à jour."; dismissible: true; dismissed => { root.status = "Fermeture 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 Rectangle.

Propriétés

Nom Type Sens
theme KitTheme in
severity AlertSeverity in
title string in
message string in
dismissible bool in

Types et variantes

Type Déclaration
enum AlertSeverity information, success, warning, error

Signaux

Voir aussi