Zum Hauptinhalt springen

ColorField

In ChatGPT öffnen
Shadow dwc-color-chooser 23.02
Java API

Die ColorField-Komponente ermöglicht es Benutzern, eine Farbe über den nativen Farbwähler des Browsers auszuwählen. Da sie auf der integrierten Implementierung des Browsers basiert, variiert ihr Erscheinungsbild je nach Browser und Plattform. Sie kann als einfaches Texteingabefeld, als plattformstandardmäßiger Farbwähler oder als benutzeroberflächenangepasste Picker-Oberfläche angezeigt werden. Diese Variation kommt dem Benutzer zugute, da die Steuerung mit dem übereinstimmt, was er bereits kennt.

Verwendung von 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 erweitert die gemeinsame Field-Klasse, die gemeinsame Funktionen für alle Feldkomponenten bereitstellt. Das folgende Beispiel ermöglicht es dem Benutzer, eine Farbe auszuwählen und ihre tetradischen Ergänzungen anzuzeigen.

Code anzeigen

Das ColorField eignet sich am besten für Szenarien, in denen die Farbauswahl ein entscheidender Bestandteil der Benutzeroberfläche oder der Anwendungsoberfläche ist. Hier sind einige Szenarien, in denen Sie ein ColorField effektiv verwenden können:

  1. Grafikdesign- und Bildbearbeitungstools: Farbfelder sind in Anwendungen, die Anpassungen über Farbauswahl ermöglichen, unerlässlich.

  2. Themenanpassung: Wenn Ihre App den Benutzern ermöglicht, Themen anzupassen, können sie mit einem Farbfeld Farben für verschiedene UI-Elemente wie Hintergründe, Text, Schaltflächen usw. auswählen.

  3. Datenvisualisierung: Stellen Sie den Benutzern ein Farbfeld zur Verfügung, um Farben für Diagramme, Grafiken, Heatmaps und andere visuelle Darstellungen auszuwählen.

Wert​

Das ColorField verwendet die java.awt.Color Klasse zum Setzen und Abrufen von Farben über die Methoden setValue() und getValue(). Während die clientseitige Komponente ausschließlich vollständig undurchsichtige RGB-Farben in hexadezimaler Notation verarbeitet, vereinfacht webforJ den Prozess, indem es Color-Werte automatisch in das korrekte Format konvertiert.

Hexadezimale Analyse

Wenn Sie die Methode setText() verwenden, um einen Wert zuzuweisen, wird das ColorField versuchen, die Eingabe als hexadezimale Farbe zu analysieren. Wenn die Analyse fehlschlägt, wird eine IllegalArgumentException ausgelöst.

Statische Hilfsmittel​

Die ColorField-Klasse bietet auch die folgenden statischen Hilfsmittelmethoden:

  • fromHex(String hex): Konvertiert einen Farbstring im Hexformat in ein Color-Objekt, das dann mit dieser Klasse oder anderswo verwendet werden kann.

  • toHex(Color color): Wandelt den gegebenen Wert in die entsprechende hexadezimale Darstellung um.

  • isValidHexColor(String hex): Überprüft, ob der angegebene Wert eine gültige 7-stellige hexadezimale Farbe ist.

Beste Praktiken​

Um ein optimales Benutzererlebnis bei der Verwendung der ColorField-Komponente zu gewährleisten, sollten Sie die folgenden bewährten Praktiken beachten:

  • Kontextuelle Unterstützung: Bieten Sie kontextuelle Unterstützung, wie Tooltips oder ein Etikett, um zu verdeutlichen, dass Benutzer eine Farbe auswählen können und deren Zweck verstehen.

  • Bereitstellung einer Standardfarbe: Haben Sie eine Standardfarbe, die im Kontext Ihrer Anwendung sinnvoll ist.

  • Angebot von Voreingestellten Farben: Fügen Sie eine Palette häufig verwendeter oder markenbindender Farben neben dem Farbfeld für eine schnelle Auswahl hinzu.