Blazor Seleção Única ComboBox
O Blazor 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.
Blazor 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.
<IgbCombo SingleSelect></IgbCombo>
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ê tiver especificado 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:
<IgbCombo SingleSelect @ref="Combo"></IgbCombo>
@code {
private IgbCombo Combo;
this.Combo.Select(new object[] { "UK01" });
}
Para desmarcar um item sem fazer uma nova seleção, chame o método deselect
.
Desmarcando itens:
<IgbCombo SingleSelect @ref="Combo"></IgbCombo>
@code {
private IgbCombo Combo;
this.Combo.Deselect(new object[] { "UK01" });
}
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.