Slint Kit Documentation

Form structure

KitFormErrorSummary

Error list that lets users reach affected fields.

Error list that lets users reach affected fields.
Native screenshot of the same example, rendered with Skia.

Supply FormErrorRow values containing a message and a valid FocusRequest. Forward error-activated to the window’s focus registry.

The heading shows the error count and each message becomes a keyboard action. Its target keeps its token and generation regardless of message position.

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

export component Example inherits Window {
    title: "KitFormErrorSummary 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: "Form Error Summary"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitFormErrorSummary { theme: root.theme; errors: [{ target: { present: true, token: 42, generation: 1, request: 1 }, message: "Enter a complete email address." }]; error-activated(request) => { root.status = "Focus field " + request.token; } }
        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 KitFieldGroup. 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
title string in
errors [FormErrorRow] in

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
struct FocusRequest present: bool, token: int, generation: int, request: int
struct FormErrorRow target: FocusRequest, message: string

Callbacks

See also