Slint Kit Documentation

Colors

KitColorPicker

sRGB editor combining hexadecimal text, channel text and sliders.

sRGB editor combining hexadecimal text, channel text and sliders.
Native screenshot of the same example, rendered with Skia.

Supply hex-text, red-text, green-text, blue-text and, when needed, alpha-text drafts. Connect each ColorChannel callback to the color controller.

Floating-point slider positions are projections of accepted bytes. gesture-started, committed and cancelled let the controller manage reversible edits; alpha is visible in .editable mode.

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

export component Example inherits Window {
    title: "KitColorPicker example";
    preferred-width: 480px;
    preferred-height: 550px;
    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: "Color Picker"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitColorPicker { theme: root.theme; label: "Accent color"; swatch: #6366f1; accepted-color: { red: 99, green: 102, blue: 241, alpha: 255 }; hex-text: "#6366F1"; red-text: "99"; green-text: "102"; blue-text: "241"; }
        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 Rectangle. 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
alpha-mode ColorAlphaMode in
accepted-color SrgbColorView in
swatch color in
label string in
hex-error string in
red-error string in
green-error string in
blue-error string in
alpha-error string in
hex-text string in-out
red-text string in-out
green-text string in-out
blue-text string in-out
alpha-text string in-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 ColorAlphaMode opaque, editable
enum ColorChannel red, green, blue, alpha
enum ControlSize compact, medium, comfortable
enum FieldAccess editable, read-only, disabled
enum NavigationStep next, previous, first, last, page-next, page-previous
struct SrgbColorView red: int, green: int, blue: int, alpha: int

Callbacks