Es un elemento de formulario que permite seleccionar una opción de entre un listado de varias.
Cuando está plegado, muestra la opción actualmente seleccionada y cuando está expandido muestra una lista desplegable de opciones predefinidas.
Este componente tiene ciertos problemas de accesibilidad. Usa mejor el componente Combobox o Select. Se mantiene por temas de retrocompabilidad pero no se recomienda su uso.
Descripción visual
Listbox con borde gris de 1px y fondo blanco. Contiene un título en texto negro tamaño estándar, un label descriptivo en texto negro regular, y un botón dropdown con elementos del listbox. El botón tiene borde gris claro y esquinas redondeadas.
Simula activar la pseudo-clase de CSS :active. En realidad sólo se usa para documentar estos ejemplos.
Descripción visual
Listbox con borde gris de 1px y fondo blanco. Contiene un título en texto negro tamaño estándar, un label descriptivo en texto negro regular, y un botón dropdown con elemento seleccionado en azul. El botón tiene borde azul y esquinas redondeadas, indicando selección activa.
Simula activar la pseudo-clase de CSS :hover. En realidad sólo se usa para documentar estos ejemplos.
Descripción visual
Listbox con borde gris de 1px y fondo blanco. Contiene un título en texto negro tamaño estándar, un label descriptivo en texto negro regular, y un botón dropdown con elementos del listbox. El botón tiene borde gris y esquinas redondeadas en estado de interacción al pasar cursor.
Simula activar la pseudo-clase de CSS :focus. En realidad sólo se usa para documentar estos ejemplos.
Descripción visual
Listbox con borde gris claro, fondo blanco, label descriptivo arriba del componente. Botón rectangular con texto negro sobre fondo amarillo intenso, borde negro fino, esquinas ligeramente redondeadas. El botón muestra indicador de desplegable.
Listbox con borde gris claro, fondo blanco, label descriptivo arriba del componente. Botón rectangular con texto blanco sobre fondo azul oscuro(teal/petróleo) , esquinas ligeramente redondeadas. El botón muestra indicador de desplegable.
Listbox con borde gris claro, fondo blanco, label descriptivo arriba del componente. Enlace de texto en color azul(teal) con indicador de desplegable, sin fondo ni borde visible. El enlace aparece subrayado indicando interactividad.
Listbox con borde gris claro de 1px, fondo blanco, conteniendo un label descriptivo en texto negro regular pequeño arriba. Botón desplegable en texto negro con fondo blanco y borde gris de 1px, incluyendo un ícono de flecha hacia abajo a la derecha.
Esto es un label
Opción 1
Opción 2
Opción 3
Opción 4
Opción 5
Mostrar códigodel ejemplo: Con estilos de cabecera
Listbox con borde gris claro de 1px, fondo blanco, conteniendo un label descriptivo en texto negro regular pequeño arriba. Botón desplegable con elementos del listbox en negro sobre fondo blanco, borde gris de 1px, y flecha hacia abajo a la derecha del texto.
Listbox con borde gris claro de 1px, fondo blanco, conteniendo un label descriptivo en texto negro regular pequeño arriba. Botón desplegable con elementos del listbox sobre fondo blanco con borde gris de 1px y ícono de flecha hacia abajo a la derecha.
Un botón con una selección aplicada se muestra con color. Label solo visible para lectores de pantalla.
Descripción visual
Listbox con fondo blanco y borde gris de 1px. Contiene un botón desplegable con elemento seleccionado en azul oscuro y un ícono de flecha hacia abajo a la derecha. El botón tiene padding interno y esquinas ligeramente redondeadas.
Listbox con encabezado en texto gris oscuro y subtexto descriptivo en gris medio debajo. Contiene un botón desplegable deshabilitado con texto gris claro, fondo gris muy tenue, y flecha hacia abajo desaturada. El botón aparece sin interactividad visual, con opacidad reducida.
Tanto el botón como los elementos del tooltip están rodeados de un div contenedor al que se le pueden aplicar estilos de CSS.
Descripción visual
Listbox con encabezado en texto negro y subtexto descriptivo en gris oscuro debajo. Contiene un botón desplegable con elementos del listbox en color turquesa/cyan, fondo cyan muy claro, y flecha hacia abajo del mismo color turquesa. El botón tiene borde cyan de 1px y padding interno visible.
Esto es un label
Opción 1
Opción 2
Opción 3
Opción 4
Opción 5
Mostrar códigodel ejemplo: Con clases de css aplicadas al container
El contenido del tooltip puede tener clases adicionales aplicadas. En este ejemplo se le ha aplicado una altura máxima y scroll vertical si el contenido se desborda.
Descripción visual
Sección con borde gris claro de 1px y fondo blanco. Título en negro tamaño mediano, seguido de label descriptivo en texto negro regular. Botón dropdown con elementos del listbox en azul y flecha hacia abajo a la derecha.
Esto es un label
Opción 1
Opción 2
Opción 3
Opción 4
Opción 5
Mostrar códigodel ejemplo: Clases aplicadas al contenido del tooltip
En este ejemplo, usando clases de CSS, la anchura del contenido establece la anchura del tooltip.
Descripción visual
Sección con borde gris claro de 1px y fondo blanco. Título en negro tamaño mediano, seguido de label descriptivo en texto negro regular. Campo de entrada tipo combobox con elementos del listbox en negro y flecha hacia abajo a la derecha, ocupando ancho completo.
Esto es un label
Opción 1
Opción 2
Opción 3
Opción 4
Opción 5
Mostrar códigodel ejemplo: Clases aplicadas a varios elementos
Podemos seleccionar inicialmente un item si le añadimos el parámetro 'active': true. También puedes usar con javascript la función global activateItemListBox(elementMenu, activeItemId) para seleccionar un item, usando sus ids. Ej: Abre la consola del navegador y escribe activateItemListBox('listbox', 'with-active-item-listbox-item-2') para seleccionar el segundo item de este ejemplo.
Descripción visual
Sección con borde gris claro de 1px y fondo blanco. Label descriptivo en texto negro regular. Botón dropdown con elemento seleccionado en azul y flecha hacia abajo a la derecha, formato compacto.
Usa el parámetro 'isMultiselectable': true. En este caso al seleccionar un item el elemento no se cerrará. También puedes usar con javascript la función global activateItemListBox(elementMenu, activeItemId) para seleccionar varios items, usando sus ids. Ej: Abre la consola del navegador y escribe activateItemListBox('listbox-multiple', ['is-multiselectable-listbox-item-2', 'is-multiselectable-listbox-item-3']) para seleccionar el segundo y el tercer item de este ejemplo.
Descripción visual
Rectángulo con borde gris de 1px y fondo blanco contiene un label descriptivo en texto gris oscuro tamaño pequeño seguido de un botón desplegable con elementos del listbox. El componente ocupa ancho completo del contenedor con padding interno y el botón tiene bordes redondeados suaves.
Esto es un label
Opción 1
Opción 2
Opción 3
Opción 4
Opción 5
Mostrar códigodel ejemplo: Permite selecciones múltiples
Usa el parámetro 'doesChangeButtonText': true para hacer que el texto del botón se actualice al seleccionar un item. Si 'doesChangeButtonText': true, entonces no tiene efecto
Descripción visual
Rectángulo con borde gris de 1px y fondo blanco contiene un label descriptivo en texto gris oscuro tamaño pequeño seguido de un botón desplegable con elementos del listbox. El componente ocupa ancho completo del contenedor con padding interno y el botón tiene bordes redondeados suaves.
Esto es un label
Option 1
Opción 2
Opción 3
Opción 4
Opción 5
Mostrar códigodel ejemplo: Cambia el texto del botón
Rectángulo con borde gris de 1px y fondo blanco contiene un label en texto gris oscuro tamaño pequeño seguido de un botón desplegable azul con flecha hacia abajo. El componente ocupa ancho completo del contenedor con padding interno y el botón tiene bordes redondeados suaves.
Componente listbox con borde gris de 1px, fondo blanco, y esquinas ligeramente redondeadas. Contiene un título h3 en negro, seguido de un label descriptivo en negro tamaño pequeño, y un botón dropdown con elementos del listbox en azul oscuro con flecha hacia abajo.
Esto es un label
Actuaciones previas/preparatorias
Consulta previa, actos preparatorios de expediente, bases reguladoras...
Podemos abrir o cerrar un menú usando con javascript la función global toggleMenuListbox(elementMenu, open) para abrir o cerrar un menú, usando su id. El parámetro open admite true o false, si le pasamos true abrirá el menú, y si le pasamos false cerrará el menú. Ej: Abre la consola del navegador y escribe toggleMenuListbox('listbox-javascript', true) para abrir el menú de este ejemplo.
Descripción visual
Componente listbox con borde gris de 1px, fondo blanco, y esquinas ligeramente redondeadas. Incluye un título h3 en negro, un label descriptivo en negro tamaño pequeño debajo, y un botón dropdown con elemento seleccionado en azul oscuro acompañado de una flecha hacia abajo a la derecha.
Esto es un label
Opción 1
Opción 2
Opción 3
Opción 4
Opción 5
Mostrar códigodel ejemplo: Menú abierto o cerrado con javascript