KitColorPicker
Éditeur sRGB combinant l’hexadécimal, les canaux textuels et leurs curseurs.

Fournissez les brouillons hex-text, red-text, green-text, blue-text et, si nécessaire, alpha-text. Reliez les callbacks de chaque ColorChannel au contrôleur de couleur.
Les positions flottantes des curseurs sont des projections des octets acceptés. gesture-started, committed et cancelled permettent au contrôleur de gérer une modification réversible ; l’alpha est visible en mode .editable.
Exemple complet
Ce fichier Slint complet présente une composition visuelle et produit la capture ci-dessus. Les textes internes sans propriété de libellé conservent la langue par défaut du kit ; les dialogues système suivent la plateforme. Les états projetés et les signaux qui demandent une décision doivent être raccordés à l’hôte ; cet exemple isolé ne fournit pas ce contrôleur. Configurer le projet Rust, puis consulter l’application avec contrôleurs typés pour relier réellement édition, validation et sélection.
// Public label overrides localize this fixture; toolkit/host defaults keep their language.
// SPDX-License-Identifier: GPL-3.0-or-later
import { KitColorPicker, KitTheme, KitThemes } from "@kit/kit.slint";
export component Example inherits Window {
title: "KitColorPicker — exemple";
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: "Sélecteur de couleur"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
KitColorPicker { theme: root.theme; label: "Couleur d’accent"; 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; }
}
}
API publique
Hérite de Rectangle.
Les déclarations suivantes sont extraites des sources du composant. Les propriétés du parent restent disponibles ; les détails de gestion d’état sont décrits dans le guide des contrôleurs.
Propriétés
| Nom | Type | Sens |
|---|---|---|
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 et variantes
Les noms ci-dessous utilisent la syntaxe Slint. Les types Rust partagés se trouvent dans slint_kit ; les enums de présentation proviennent des types Rust générés par Slint.
| Type | Déclaration |
|---|---|
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 |
Signaux
hex-edited(string)hex-commit-requested(string)color-requested(SrgbColorView)channel-edited(ColorChannel,string)channel-commit-requested(ColorChannel,string)channel-position-requested(ColorChannel,float)channel-navigate(ColorChannel,NavigationStep)gesture-started(ColorChannel)committed(ColorChannel)cancelled(ColorChannel)