KitNumberStepper

Champ numérique avec actions d’incrémentation et de décrémentation.

Liez text au brouillon et traitez step-requested(StepDirection) dans le même contrôleur exact que la saisie. Projetez les limites avec can-increment et can-decrement.

Les boutons demandent StepDirection.increment ou .decrement sans calcul local de montant. FieldAccess.read-only conserve le texte consultable et désactive les actions.

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 { 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. 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`
`label`	`string`	`in`
`description`	`string`	`in`
`error`	`string`	`in`
`placeholder`	`string`	`in`
`prefix`	`string`	`in`
`suffix`	`string`	`in`
`can-increment`	`bool`	`in`
`can-decrement`	`bool`	`in`
`increment-label`	`string`	`in`
`decrement-label`	`string`	`in`
`text`	`string`	`in-out`
`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 StepDirection`	`increment, decrement`
`enum ValidationPresentation`	`pristine, checking, valid, invalid`

Signaux

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

Fonctions

take-focus()

Voir aussi

KitField