Slint Kit Documentation

Saisie de texte

KitTextField

Champ de texte natif avec libellé, validation et messages d’aide.

Champ de texte natif avec libellé, validation et messages d’aide.
Capture native du même exemple, moteur Skia.

Liez text au brouillon et traitez edited, commit-requested et cancelled dans un contrôleur typé. Définissez FieldAccess.editable, .read-only ou .disabled selon les droits réels.

Le même TextInput conserve sélection, curseur, annulation et composition IME lors des changements visuels. ValidationPresentation présente la validation ; le contrôleur garde les valeurs acceptées et fournit le compte de graphèmes.

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

export component Example inherits Window {
    title: "KitTextField — 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 de texte"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitTextField { character-count-label: "caractères"; checking-label: "Vérification…"; clear-label: "Effacer la recherche"; hide-label: "Masquer le mot de passe"; reveal-label: "Afficher le mot de passe"; theme: root.theme; label: "Nom du projet"; text: "Notes de terrain"; 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. 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

Nom Type Sens
theme KitTheme in
control-size ControlSize in
access FieldAccess in
validation ValidationPresentation in
purpose TextPurpose in
secret-visibility SecretVisibility in-out
line-mode TextLineMode in
resize-policy ResizePolicy in
min-lines int in
max-lines int in
label string in
accessible-name string in
input-method-hints InputMethodHints in
description string in
error string in
placeholder string in
text-letter-spacing length in
text-alignment TextHorizontalAlignment in
prefix string in
suffix string in
text string in-out
show-character-count bool in
character-count int in
reveal-label string in
hide-label string in
clear-label string in
character-count-label string in
checking-label string in
has-focus bool out

Types et variantes

Les noms ci-dessous utilisent la syntaxe Slint. Les types Rust partagés se trouvent dans slint_kit ; les enums de présentation proviennent des types Rust générés par Slint.

Type Déclaration
enum ControlSize compact, medium, comfortable
enum FieldAccess editable, read-only, disabled
enum ResizePolicy fixed, auto-grow
enum SecretVisibility hidden, revealed
enum TextLineMode single-line, multiline
enum TextPurpose plain, email, url, telephone, password, search
enum ValidationPresentation pristine, checking, valid, invalid

Signaux

Fonctions

Voir aussi