Slint Kit Documentation

Buttons and actions

KitButtonGroup

Row of related buttons with consistent spacing.

Row of related buttons with consistent spacing.
Native screenshot of the same example, rendered with Skia.

Place actions in reading order, such as Cancel followed by Save. Each child chooses its own width and intent.

The group uses a start-aligned HorizontalLayout and keeps its natural height. It does not merge button focus or callbacks.

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

export component Example inherits Window {
    title: "KitButtonGroup example";
    preferred-width: 360px;
    preferred-height: 160px;
    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: "Button Group"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitButtonGroup { KitButton { theme: root.theme; text: "Back"; activated => { root.status = "Action requested"; } }KitButton { theme: root.theme; text: "Next"; activated => { root.status = "Action requested"; } } }
        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 HorizontalLayout. The declarations below come from the component source. Parent properties remain available; see the controller guide for state management.