Overslaan naar hoofdinhoud

ColorField

Openen in ChatGPT
Shadow dwc-color-chooser 23.02
Java API

De ColorField component laat gebruikers een kleur selecteren via de ingebouwde kleurkiezer van de browser. Omdat het afhankelijk is van de ingebouwde implementatie van de browser, varieert het uiterlijk tussen browsers en platforms. Het kan worden weergegeven als een eenvoudige tekstinvoerveld, een op het platform gestandaardiseerde kleurkiezer, of een aangepaste picker-interface. Deze variatie werkt in het voordeel van de gebruiker, omdat de besturingselementen overeenkomen met wat ze al kennen.

Gebruik van 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 breidt de gedeelde Field klasse uit, die gemeenschappelijke functies biedt voor alle veldcomponenten. Het volgende voorbeeld laat de gebruiker een kleur kiezen en toont de tetradische complementen ervan.

Toon Code

De ColorField is het beste te gebruiken in scenario's waar kleurselectie een cruciaal onderdeel van de gebruikersinterface of app-interface is. Hier zijn enkele scenario's waarin je een ColorField effectief kunt gebruiken:

  1. Grafisch Ontwerp en Afbeeldingsbewerkingshulpmiddelen: Kleurenvelden zijn essentieel in apps die aanpassing via kleurselectie vereisen.

  2. Thema Personalizatie: Als je app gebruikers toestaat om thema's aan te passen, stelt een kleurenveld hen in staat om kleuren voor verschillende UI-elementen te kiezen, zoals achtergronden, tekst, knoppen, enz.

  3. Gegevensvisualisatie: Bied gebruikers een kleurenveld om kleuren te selecteren voor grafieken, diagrammen, warmtemappen en andere visuele representaties.

Waarde​

De ColorField gebruikt de java.awt.Color klasse om kleuren in te stellen en op te halen via de methoden setValue() en getValue(). Terwijl de client-side component exclusief volledig ondeugdelijke RGB-kleuren in hexadecimale notatie verwerkt, stroomlijnt webforJ het proces door Color waarden automatisch om te zetten in het juiste formaat.

Hexadecimale parsing

Bij gebruik van de setText() methode om een waarde toe te wijzen, zal de ColorField proberen de invoer te parseren als een hexadecimale kleur. Als de parsing mislukt, wordt er een IllegalArgumentException opgegooid.

Statische hulpprogramma's​

De ColorField klasse biedt ook de volgende statische hulpprogramma's:

  • fromHex(String hex): Zet een kleurstring in hex-formaat om naar een Color object dat vervolgens kan worden gebruikt met deze klasse, of elders.

  • toHex(Color color): Zet de opgegeven waarde om naar de bijbehorende hex-representatie.

  • isValidHexColor(String hex): Controleer of de opgegeven waarde een geldige 7-cijferige hex-kleur is.

Beste praktijken​

Om een optimale gebruikerservaring te garanderen bij het gebruik van de ColorField component, overweeg dan de volgende beste praktijken:

  • Contexte hulp: Bied contextuele hulp, zoals tooltips of een label, om te verduidelijken dat gebruikers een kleur kunnen selecteren en het doel ervan te begrijpen.

  • Bied een Standaardkleur: Heb een standaardkleur die logisch is in de context van je app.

  • Bied Vooraf Gedefinieerde Kleuren Aan: Inclusief een palet van vaak gebruikte of merkgerichte kleuren naast het kleurenveld voor snelle selectie.