Slint Kit Documentation

Text input

KitTelephoneField

Native field for an editable telephone number.

Native field for an editable telephone number.
Native screenshot of the same example, rendered with Skia.

Keep spaces, signs and incomplete drafts in text. Delegate regional interpretation and the accepted value to a typed controller.

It sets purpose: TextPurpose.telephone and inherits KitTextField callbacks. It imposes no mask or international format.

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

export component Example inherits Window {
    title: "KitTelephoneField 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: "Telephone Field"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitTelephoneField { theme: root.theme; label: "Phone"; text: "+1 514 555 0132"; 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 KitTextField. The declarations below come from the component source. Parent properties remain available; see the controller guide for state management.

See also