Slint Kit Documentation

Numbers and money

KitNumberStepper

Numeric field with increment and decrement actions.

Numeric field with increment and decrement actions.
Native screenshot of the same example, rendered with Skia.

Bind text to the draft and handle step-requested(StepDirection) in the same exact-value controller as text input. Project limits through can-increment and can-decrement.

Buttons request StepDirection.increment or .decrement without local amount arithmetic. FieldAccess.read-only keeps text available and disables the actions.

View source ↗

Complete example

This complete Slint file is a visual composition used to produce the screenshot above. Internal strings without a label property retain the kit’s default language; system dialogs follow the host platform. Projected state and callbacks requesting a decision need host wiring; the standalone fixture does not supply that controller. Set up the Rust project, then see the typed controller application for working editing, validation and selection.

// SPDX-License-Identifier: GPL-3.0-or-later
import { KitNumberStepper, KitTheme, KitThemes } from "@kit/kit.slint";

export component Example inherits Window {
    title: "KitNumberStepper example";
    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: "Number Stepper"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitNumberStepper { theme: root.theme; label: "Guests"; text: "3"; step-requested(direction) => { root.status = "Step requested; validate in Rust"; }; edited(value) => { root.status = "Draft: " + value; } }
        if root.status != "": Text { text: root.status; color: root.theme.text-secondary; font-size: 12px * root.theme.text-scale; wrap: word-wrap; }
    }
}

Download this example

Public API

Inherits KitField. The declarations below come from the component source. Parent properties remain available; see the controller guide for state management.

Properties

Name Type Direction
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 and variants

Names below use Slint syntax. Shared Rust domain types live in slint_kit; presentation enums come from the Rust types generated by Slint.

Type Declaration
enum ControlSize compact, medium, comfortable
enum FieldAccess editable, read-only, disabled
enum StepDirection increment, decrement
enum ValidationPresentation pristine, checking, valid, invalid

Callbacks

Functions

See also