Saltar al contenido principal

ListBox

Abrir en ChatGPT
Sombra dwc-listbox 23.05
Java API

El componente ListBox muestra una lista desplazable de elementos que permanece visible sin necesidad de abrir un menú desplegable. Soporta selecciones tanto individuales como múltiples, y funciona bien cuando los usuarios necesitan ver todas las opciones disponibles al mismo tiempo.

Usos​

Inheritance

This class is a List component, and inherits its features and behaviors. For an overview of List properties, events, and other important information, please refer to the List documentation.

  1. Asignación de Rol de Usuario: En aplicaciones con control de acceso de usuarios, los administradores pueden utilizar un ListBox para asignar roles y permisos a los usuarios. Los usuarios son seleccionados de una lista y los roles o permisos se asignan en función de su selección. Esto asegura un acceso preciso y controlado a diferentes características y datos dentro de la aplicación.

  2. Asignación de Tareas de Proyecto: En software de gestión de proyectos, los componentes ListBox son útiles para asignar tareas a los miembros del equipo. Los usuarios pueden seleccionar tareas de una lista y asignarlas a diferentes miembros del equipo. Esto simplifica la delegación de tareas y asegura que las responsabilidades estén claramente definidas dentro del equipo.

  3. Filtrado por Múltiples Categorías: En una aplicación de búsqueda, los usuarios a menudo necesitan filtrar resultados de búsqueda basándose en múltiples criterios. Un ListBox puede mostrar varias opciones de filtro, tales como

  • Características del producto
  • Rangos de precios
  • Marcas.

Los usuarios pueden seleccionar elementos de cada categoría de filtro, lo que les permite refinar los resultados de búsqueda y encontrar exactamente lo que están buscando.

  1. Categorización de Contenido: En sistemas de gestión de contenido, los componentes ListBox ayudan a categorizar artículos, imágenes o archivos. Los usuarios pueden seleccionar una o más categorías para asociar con su contenido, facilitando la organización y búsqueda de elementos de contenido en el sistema.

Opciones de Selección​

Por defecto, el cuadro de lista está configurado para permitir la selección de un solo elemento a la vez. Sin embargo, el ListBox implementa la interfaz MultipleSelectableList, que puede ser configurada con un método integrado que permite a los usuarios seleccionar múltiples elementos usando la tecla Shift para selecciones contiguas y tecla Control (Windows) o Command (Mac) para selecciones múltiples separadas.

Utilice la función setSelectionMode() para cambiar esta propiedad. Este método acepta SelectionMode.SINGLE o SelectionMode.MULTIPLE.

Comportamiento en dispositivos táctiles

En dispositivos táctiles, cuando la selección múltiple está habilitada, los usuarios pueden seleccionar múltiples elementos sin mantener presionada la tecla shift.

Además, se pueden usar las teclas de flecha para navegar por el ListBox, y escribir una letra mientras el ListBox tiene el foco seleccionará la opción que comienza con esa letra, o recorrerá las opciones que comienzan con esa letra si existen múltiples opciones.

Mostrar Código

Estilo​

Loading...

Mejores Prácticas​

Para garantizar una experiencia óptima del usuario al utilizar el componente ChoiceBox, considere las siguientes mejores prácticas:

  1. Priorizar la Jerarquía de la Información: Al utilizar un ListBox, asegúrese de que los elementos estén organizados en un orden lógico y jerárquico. Coloque las opciones más importantes y comúnmente utilizadas en la parte superior de la lista. Esto facilita que los usuarios encuentren lo que necesitan sin desplazamientos excesivos.

  2. Limitar la Longitud de la Lista: Evite abrumar a los usuarios con un ListBox excesivamente largo. Si hay un gran número de elementos para mostrar, considere implementar paginación, búsqueda u opciones de filtrado para ayudar a los usuarios a localizar elementos rápidamente. Alternativamente, puede agrupar elementos en categorías para reducir la longitud de la lista.

  3. Etiquetas Claras y Descriptivas: Proporcione etiquetas claras y descriptivas para cada elemento en el ListBox. Los usuarios deben poder entender el propósito de cada opción sin ambigüedad. Utilice etiquetas de elementos concisas y significativas.

  4. Retroalimentación de Selección Múltiple: Si su ListBox permite selecciones múltiples, proporcione retroalimentación visual o textual indicando que se pueden seleccionar múltiples elementos de la lista.

  5. Selección Predeterminada: Considere establecer una selección predeterminada para el ListBox, especialmente si una opción se usa más comúnmente que otras. Esto puede simplificar la experiencia del usuario al preseleccionar la opción más probable.