Zum Hauptinhalt springen

ColorField

In ChatGPT öffnen
Schatten 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 Implementation des Browsers basiert, variiert ihr Erscheinungsbild je nach Browser und Plattform. Es kann als einfaches Texteingabefeld, als plattformstandardmäßiger Farbwähler oder als benutzerdefiniertes Wähl-Interface angezeigt werden. Diese Variation kommt den Benutzern zugute, da die Steuerung dem entspricht, was sie bereits gewohnt sind.

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 deren tetradische Komplementärfarben anzuzeigen.

Code anzeigen

Das ColorField ist am besten in Szenarien geeignet, in denen die Farbauswahl ein entscheidender Teil der Benutzeroberfläche oder der Anwendungsoberfläche ist. Hier sind einige Szenarien, in denen Sie ein ColorField effektiv nutzen können:

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

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

  3. Datenvisualisierung: Bieten Sie den Benutzern ein Farbfeld zur Auswahl von Farben für Diagramme, Graphen, Heatmaps und andere visuelle Darstellungen.

Wert​

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

Hexadezimale Analyse

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

Statische Hilfsfunktionen​

Die ColorField-Klasse bietet auch die folgenden statischen Hilfsfunktionen:

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

  • toHex(Color color): Konvertiert den angegebenen Wert in die entsprechende hexadezimale Darstellung.

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

Beste Praktiken​

Um ein optimales Benutzererlebnis beim Einsatz der ColorField-Komponente zu gewährleisten, sollten die folgenden bewährten Praktiken berücksichtigt werden:

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

  • Standardfarbe bereitstellen: Stellen Sie eine Standardfarbe zur Verfügung, die im Kontext Ihrer App sinnvoll ist.

  • Voreingestellte Farben anbieten: Fügen Sie eine Palette häufig verwendeter oder markenspezifischer Farben neben dem Farbfeld zur schnellen Auswahl hinzu.