Web Components Seleção Única ComboBox
O Web Components ComboBox suporta modo de seleção única e filtragem rápida da lista de itens por meio do prompt de entrada principal. Os usuários podem digitar rapidamente o item que estão procurando e receber uma lista de opções. Ao pressionar a tecla Enter, a primeira correspondência destacada será selecionada.
Web Components Single Selection Example
Para habilitar seleção única e filtragem rápida, defina a propriedade singleSelect no componente ComboBox. A experiência do usuário e a navegação pelo teclado permanecerão basicamente as mesmas, mas em vez de ter que digitar sua consulta de pesquisa em uma caixa de filtragem especial acima da lista de opções, a caixa de entrada principal será usada.
<igc-combo single-select></igc-combo>
Selection API
A API de seleção para um ComboBox com a propriedade singleSelect aplicada permanece praticamente a mesma, no entanto, há algumas diferenças importantes em comparação com ComboBoxes que não têm essa propriedade definida.
A principal diferença é que apenas um item pode ser selecionado a qualquer momento. Por exemplo, se você especificou um valueKey para seu componente combo, passar mais de um item para os métodos select / deselect não terá efeito. Isso também significa que quaisquer itens selecionados anteriormente serão automaticamente desmarcados ao fazer uma nova seleção.
Veja como selecionar/desmarcar um item programaticamente em uma única combinação de seleção.
Selecionando itens:
// select the item matching the 'BG01' value of the value key field.
combo.select('BG01');
Para desmarcar um item sem fazer uma nova seleção, chame o método deselect.
Desmarcando itens:
// deselect the item matching the 'BG01' value of the value key field.
combo.deselect('BG01');
Disabled features
Naturalmente, algumas opções de configuração não terão efeito em uma única ComboBox de seleção.
Placeholder
Atribuir um valor à propriedade placeholderSearch não produzirá nenhum resultado, pois a entrada de filtragem que geralmente é colocada acima da lista de opções não estará presente em uma única ComboBox de seleção.
Autofocusing the list of options
Definir a opção autofocusList em uma única seleção ComboBox também não terá efeito.
Keyboard Navigation
A navegação pelo teclado deve se comportar da mesma forma que em uma ComboBox sem seleção única, exceto pelo fato de que agora a entrada principal desempenha a função de um prompt de filtragem e, portanto, todas as ações do teclado que se aplicam à entrada de filtragem/pesquisa são movidas para o prompt de entrada principal.
Other Features
Todos os outros recursos se comportarão da mesma forma que em um componente ComboBox sem seleção única.