Passer au contenu principal

ColorField

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

Le composant ColorField permet aux utilisateurs de sélectionner une couleur via le sélecteur de couleurs natif du navigateur. Parce qu'il repose sur l'implémentation intégrée du navigateur, son apparence varie selon les navigateurs et les plateformes. Il peut se présenter sous la forme d'un simple champ de texte, d'un sélecteur de couleurs standard de la plateforme, ou d'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 prolonge la classe partagée Field, 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 idéal dans des scénarios où la sélection des couleurs est une partie cruciale de l'interface utilisateur ou de l'interface de l'application. Voici quelques scénarios où vous pouvez utiliser un ColorField efficacement :

  1. Outils de design graphique et d'édition d'images : Les champs de couleur sont essentiels dans les applications qui impliquent des personnalisations via la sélection de couleurs.

  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 des arrière-plans, du texte, des boutons, etc.

  3. Visualisation des données : Offrez aux utilisateurs un champ de couleur pour sélectionner des couleurs pour des graphiques, des courbes, des cartes de chaleur 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(). Bien que le composant côté client gère exclusivement des couleurs RGB complètement opaques en notation hexadécimale, webforJ simplifie le processus en convertissant automatiquement les valeurs Color dans le format correct.

Analyse hexadécimale

Lors de l'utilisation de 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, considérez les meilleures pratiques suivantes :

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

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

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