Présentation

KitEmptyState

Présentation d’une collection vide avec explication et contenu d’action libre.

Fournissez title et description pour expliquer la situation, puis ajoutez une action utile comme enfant. Distinguez une absence de résultats d’un chargement ou d’une erreur dans l’état de l’application.

Les textes reviennent à la ligne et le composant mesure sa hauteur depuis le contenu. Il ne décide pas quand une collection est vide.

Voir le code source ↗

Exemple complet

Ce fichier Slint complet présente une composition visuelle et produit la capture ci-dessus. Les textes internes sans propriété de libellé conservent la langue par défaut du kit ; les dialogues système suivent la plateforme. Les états projetés et les signaux qui demandent une décision doivent être raccordés à l’hôte ; cet exemple isolé ne fournit pas ce contrôleur. Configurer le projet Rust, puis consulter l’application avec contrôleurs typés pour relier réellement édition, validation et sélection.

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

export component Example inherits Window {
    title: "KitEmptyState — exemple";
    preferred-width: 480px;
    preferred-height: 310px;
    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: "État vide"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitEmptyState { theme: root.theme; title: "Aucun projet pour le moment"; description: "Créez un projet pour commencer à rassembler vos idées."; KitButton { theme: root.theme; text: "Créer un projet"; 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 Rectangle. Les déclarations suivantes sont extraites des sources du composant. Les propriétés du parent restent disponibles ; les détails de gestion d’état sont décrits dans le guide des contrôleurs.

Propriétés