Saltar al contenido principal

ColorField

Abrir en ChatGPT
Sombra dwc-color-chooser 23.02
Java API

El componente ColorField permite a los usuarios seleccionar un color a través del selector de color nativo del navegador. Debido a que se basa en la implementación incorporada del navegador, su apariencia varía entre navegadores y plataformas. Puede mostrarse como una simple entrada de texto, un selector de color estándar de la plataforma o una interfaz de selector personalizada. Esta variación juega a favor del usuario, ya que el control coincide con lo que ya conocen.

Usando 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 extiende la clase compartida Field, que proporciona características comunes en todos los componentes de campo. El siguiente ejemplo permite al usuario elegir un color y muestra sus complementos tetrádicos.

Mostrar Código

El ColorField se utiliza mejor en escenarios donde la selección de color es una parte crucial de la interfaz de usuario o de la aplicación. Aquí hay algunos escenarios donde puedes usar un ColorField de manera efectiva:

  1. Herramientas de Diseño Gráfico y Edición de Imágenes: Los campos de color son esenciales en aplicaciones que implican personalización a través de la selección de colores.

  2. Personalización de Temas: Si tu aplicación permite a los usuarios personalizar temas, usar un campo de color les permite elegir colores para diferentes elementos de la interfaz de usuario, como fondos, texto, botones, etc.

  3. Visualización de Datos: Proporciona a los usuarios un campo de color para seleccionar colores para gráficos, tablas, mapas de calor y otras representaciones visuales.

Valor​

El ColorField utiliza la clase java.awt.Color para establecer y recuperar colores a través de los métodos setValue() y getValue(). Mientras que el componente del lado del cliente maneja exclusivamente colores RGB completamente opacos en notación hexadecimal, webforJ simplifica el proceso al convertir automáticamente los valores de Color en el formato correcto.

Análisis hexadecimal

Al usar el método setText() para asignar un valor, el ColorField intentará analizar la entrada como un color hexadecimal. Si el análisis falla, se lanzará una IllegalArgumentException.

Utilidades estáticas​

La clase ColorField también proporciona los siguientes métodos de utilidades estáticas:

  • fromHex(String hex): Convierte una cadena de color en formato hex a un objeto Color que se puede utilizar con esta clase, o en otro lugar.

  • toHex(Color color): Convierte el valor dado a su representación hex correspondiente.

  • isValidHexColor(String hex): Verifica si el valor dado es un color hexadecimal válido de 7 caracteres.

Mejores prácticas​

Para asegurar una experiencia óptima del usuario al utilizar el componente ColorField, considera las siguientes mejores prácticas:

  • Asistencia Contextual: Proporciona asistencia contextual, como información sobre herramientas o una etiqueta, para aclarar que los usuarios pueden seleccionar un color y entender su propósito.

  • Proporciona un Color Predeterminado: Ten un color predeterminado que tenga sentido para el contexto de tu aplicación.

  • Ofrece Colores Preestablecidos: Incluye una paleta de colores comúnmente utilizados o alineados a tu marca junto al campo de color para una selección rápida.