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 tanto selección única como múltiple, y funciona bien cuando los usuarios necesitan ver todas las opciones disponibles a la vez.

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 Roles 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 del 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 de 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 asociarlas 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 configurarse con un método incorporado que permite a los usuarios seleccionar múltiples elementos usando la tecla Shift para una selección de entrada contigua y la tecla Control (Windows) o Command (Mac) para la selección de varios elementos separados.

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

Comportamiento en dispositivos táctiles

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

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

Mostrar Código

Estilización​

Loading...

Mejores Prácticas​

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

  1. Priorizar la Jerarquía de Información: Al usar 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 comprender el propósito de cada opción sin ambigüedad. Utilice etiquetas de ítem concisas y significativas.

  4. Retroalimentación de Selección Múltiple: Si su ListBox permite múltiples selecciones, proporcione retroalimentación visual o textual que indique 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 es más utilizada que las demás. Esto puede agilizar la experiencia del usuario al preseleccionar la opción más probable.