KitColorField

Champ hexadécimal sRGB avec nuancier et sélecteur contextuel.

Liez text au brouillon, accepted-color à la projection validée et swatch à sa couleur de rendu. Choisissez ColorAlphaMode.opaque ou .editable et traitez les demandes textuelles ou color-requested.

Le sélecteur ouvre un brouillon local depuis la couleur acceptée ; l’application n’accepte que la demande finale. Les canaux de SrgbColorView sont des octets sRGB, sans conversion implicite HSL ou RGB linéaire.

Voir le code source ↗

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

export component Example inherits Window {
    title: "KitColorField — exemple";
    preferred-width: 420px;
    preferred-height: 210px;
    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: "Champ de couleur"; color: root.theme.text-primary; font-size: 20px * root.theme.text-scale; font-weight: 600; }
        KitColorField { theme: root.theme; label: "Couleur d’accent"; swatch: #6366f1; accepted-color: { red: 99, green: 102, blue: 241, alpha: 255 }; text: "#6366F1"; }
        if root.status != "": Text { text: root.status; color: root.theme.text-secondary; font-size: 12px * root.theme.text-scale; wrap: word-wrap; }
    }
}

Télécharger cet exemple

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`
`error`	`string`	`in`
`text`	`string`	`in-out`
`picker-open`	`bool`	`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 ControlSize`	`compact, medium, comfortable`
`enum FieldAccess`	`editable, read-only, disabled`
`struct SrgbColorView`	`red: int, green: int, blue: int, alpha: int`

Signaux

edited(string)
commit-requested(string)
cancelled()
color-requested(SrgbColorView)

Fonctions

open-picker()
cancel-picker()
take-focus()

Voir aussi

KitColorPicker