Passer au contenu principal

ColorField

Ouvrir dans ChatGPT
Ombre dwc-color-chooser 23.02
Java API

Le composant ColorField permet aux utilisateurs de sélectionner une couleur via le sélecteur de couleur natif du navigateur. Étant donné qu'il s'appuie sur l'implémentation intégrée du navigateur, son apparence varie d'un navigateur à l'autre et d'une plateforme à l'autre. Il peut apparaître comme un simple champ de texte, un sélecteur de couleur standard de la plateforme ou une interface de sélection personnalisée. Cette variation joue en faveur de l'utilisateur, car le contrôle correspond à ce qu'il connaît déjà.

Utilisation de ColorField​

Inheritance

This class is a Field component, and inherits its features and behaviors. For an overview of Field properties, events, and other important information, please refer to the Field documentation.

ColorField étend la classe Field partagée, qui fournit des fonctionnalités communes à tous les composants de champ. L'exemple suivant permet à l'utilisateur de choisir une couleur et d'afficher ses compléments tétradique.

Afficher le code

Le ColorField est particulièrement utile dans les scénarios où la sélection de couleur est une partie cruciale de l'interface utilisateur ou de l'interface d'application. Voici quelques scénarios où vous pouvez utiliser un ColorField efficacement :

  1. Outils de design graphique et d'édition d'image : Les champs de couleur sont essentiels dans les applications qui impliquent une personnalisation via la sélection de couleur.

  2. Personnalisation de thème : Si votre application permet aux utilisateurs de personnaliser des thèmes, l'utilisation d'un champ de couleur leur permet de choisir des couleurs pour différents éléments de l'interface utilisateur, tels que les arrière-plans, le texte, les boutons, etc.

  3. Visualisation des données : Offrez aux utilisateurs un champ de couleur pour sélectionner des couleurs pour des graphiques, des diagrammes, des cartes thermiques et d'autres représentations visuelles.

Valeur​

Le ColorField utilise la classe java.awt.Color pour définir et récupérer des couleurs via les méthodes setValue() et getValue(). Alors que le composant côté client gère exclusivement les couleurs RGB entièrement opaques en notation hexadécimale, webforJ simplifie le processus en convertissant automatiquement les valeurs Color dans le format correct.

Analyse hexadécimale

Lorsque vous utilisez la méthode setText() pour attribuer une valeur, le ColorField tentera d'analyser l'entrée comme une couleur hexadécimale. Si l'analyse échoue, une IllegalArgumentException sera levée.

Utilitaires statiques​

La classe ColorField fournit également les méthodes utilitaires statiques suivantes :

  • fromHex(String hex) : Convertir une chaîne de couleur au format hexadécimal en un objet Color qui peut ensuite être utilisé avec cette classe ou ailleurs.

  • toHex(Color color) : Convertir la valeur donnée en la représentation hexadécimale correspondante.

  • isValidHexColor(String hex) : Vérifier si la valeur donnée est une couleur hexadécimale valide de 7 caractères.

Meilleures pratiques​

Pour garantir une expérience utilisateur optimale lors de l'utilisation du composant ColorField, tenez compte des meilleures pratiques suivantes :

  • Assistance contextuelle : Fournissez une assistance contextuelle, comme des infobulles ou une étiquette, pour clarifier que les utilisateurs peuvent sélectionner une couleur et comprendre son objectif.

  • Fournir une couleur par défaut : Ayez une couleur par défaut qui a du sens pour le contexte de votre application.

  • Offrir des couleurs prédéfinies : Incluez une palette de couleurs couramment utilisées ou en accord avec la marque à côté du champ de couleur pour une sélection rapide.