Slint Kit Documentation

Text input

KitEmailField

Native field presenting an email address draft.

Native field presenting an email address draft.
Native screenshot of the same example, rendered with Skia.

Use inherited callbacks to pass text to the application’s address validator. Supply a label and a precise error message.

It sets purpose: TextPurpose.email and defaults away from prose-oriented input hints. The presentation purpose does not validate the address or rewrite its draft.

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

export component Example inherits Window {
    title: "KitEmailField 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: "Email Field"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitEmailField { theme: root.theme; label: "Email address"; text: "alex@example.com"; 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