Saltar al contenido principal

ColorField

Abrir en ChatGPT
Shadow 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 interna del navegador, su apariencia varía entre navegadores y plataformas. Puede mostrarse como un simple campo de texto, un selector de color estándar de la plataforma, o una interfaz de selección personalizada. Esta variación trabaja 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 a 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 es mejor utilizado en escenarios donde la selección de color es una parte crucial de la interfaz de usuario o la interfaz 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 color.

  2. Personalización de Temas: Si tu aplicación permite a los usuarios personalizar temas, utilizar 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, gráficos, 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 opacos en notación hexadecimal, webforJ agiliza el proceso convirtiendo 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 utilidad estática:

  • fromHex(String hex): Convierte una cadena de color en formato hex a un objeto Color que luego puede ser utilizado con esta clase, o en otros lugares.

  • toHex(Color color): Convierte el valor dado a la 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 garantizar una experiencia óptima del usuario al usar el componente ColorField, considera las siguientes mejores prácticas:

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

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

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