Cuadro combinado de selección única Web Components
El ComboBox Web Components admite el modo de selección única y el filtrado rápido de la lista de elementos a través del mensaje de entrada principal. Los usuarios pueden escribir rápidamente el elemento que están buscando y se les presentará una lista de opciones. Al presionar la tecla Intro, se seleccionará la primera coincidencia resaltada.
Web Components Single Selection Example
Para habilitar la selección única y el filtrado rápido, establezca la propiedad singleSelect en el componente ComboBox. La experiencia del usuario y la navegación con el teclado seguirán siendo prácticamente las mismas, pero en lugar de tener que escribir su consulta de búsqueda en un cuadro de filtrado especial encima de la lista de opciones, se utilizará el cuadro de entrada principal.
<igc-combo single-select></igc-combo>
Selection API
La API de selección para un ComboBox con la propiedad singleSelect aplicada sigue siendo prácticamente la misma; sin embargo, existen algunas diferencias importantes en comparación con los ComboBox que no tienen esta propiedad establecida.
La principal diferencia es que sólo se puede seleccionar un elemento a la vez. Por ejemplo, si ha especificado una valueKey para su componente combinado, pasar más de un elemento a los métodos select / deselect no tendrá ningún efecto. Esto también significa que cualquier elemento seleccionado previamente se deseleccionará automáticamente al realizar una nueva selección.
A continuación se explica cómo seleccionar/deseleccionar un elemento mediante programación en un combo de selección única.
Seleccionar elementos:
// select the item matching the 'BG01' value of the value key field.
combo.select('BG01');
Para anular la selección de un elemento sin realizar una nueva selección, llame al método deselect.
Deseleccionar elementos:
// deselect the item matching the 'BG01' value of the value key field.
combo.deselect('BG01');
Disabled features
Naturalmente, algunas opciones de configuración no tendrán efecto en un ComboBox de selección única.
Placeholder
Asignar un valor a la propiedad placeholderSearch no producirá ningún resultado ya que la entrada de filtrado que normalmente se coloca encima de la lista de opciones no estará presente en un único cuadro combinado de selección.
Autofocusing the list of options
Configurar la opción autofocusList en un ComboBox de selección única tampoco tendrá ningún efecto.
Keyboard Navigation
La navegación con el teclado debe comportarse igual que con un ComboBox de selección no única, excepto por el hecho de que ahora la entrada principal desempeña el papel de un mensaje de filtrado y, por lo tanto, todas las acciones del teclado que se aplican a la entrada de filtrado/búsqueda se mueven al menú principal. mensaje de entrada.
Other Features
Todas las demás funciones se comportarán igual que en un componente ComboBox que no sea de selección única.