React Single Selection ComboBox
The React ComboBox supports single-selection mode and quick filtering of the list of items via the main input prompt. Users can quickly type in the item they are looking for and be presented with a list of options. Upon pressing the enter key, the first highlighted match will be selected.
React Single Selection Example
Para permitir seleção única e filtragem rápida, defina asingleSelect propriedade em .IgrCombo A experiência do usuário e a navegação por teclado permanecerão basicamente as mesmas, mas, em vez de precisar digitar sua consulta de busca em uma caixa de filtragem especial acima da lista de opções, será usada a caixa principal de entrada.
<IgrCombo singleSelect></IgrCombo>
Selection API
A API de seleção para um ComboBox com asingleSelect propriedade aplicada permanece praticamente a mesma, porém há algumas diferenças importantes em relação às ComboBoxes que não possuem essa propriedade definida.
A principal diferença é que apenas um item pode ser selecionado por vez. Por exemplo, se você especificou avalueKey para seu componente de combo, passar mais de um item para oselect /deselect métodos não terá efeito. Isso também significa que quaisquer itens previamente selecionados serão automaticamente desselecionados ao fazer uma nova seleção.
Veja como selecionar/desmarcar um item programaticamente em uma única combinação de seleção.
Selecting items
// select the item matching the 'BG01' value of the value key field.
comboRef.current.select('BG01');
Para desmarcar um item sem fazer uma nova seleção, chame odeselect método.
Desclassificação de itens
// deselect the item matching the 'BG01' value of the value key field.
comboRef.current.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 àplaceholderSearch propriedade não trará resultado, já que a entrada de filtragem que normalmente está acima da lista de opções não estará presente em uma única ComboBox de seleção.
Auto-focusing the list of options
Configurar aautofocusList opção em uma única ComboBox de seleção 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.