Importação

import-select.ts
import { type NuiOption, NuiSelect } from '@needless-ui/angular/select';

NuiSelect

Um botão que abre uma lista de opções.

Seletor
nui-select
NuiSelect: Propriedades
NomeTipoPadrãoDescrição
optionsInputNuiOption<V>[]As opções, como objetos NuiOption.
valueBidirecionalV | nullnullO valor escolhido, ou null. Também funciona com formulários.
valuesBidirecionalreadonly V[][]Os valores escolhidos, com multiple.
multipleInputbooleanfalsePermite escolher várias opções. A lista fica aberta enquanto você escolhe.
selectAllInputbooleanfalseCom multiple, adiciona um botão que marca ou desmarca todas as opções.
placeholderInputstring'Select…'Texto mostrado enquanto nada foi escolhido.
labelInputstringNome acessível, quando nenhum <label> nomeia o botão.
triggerIdInputstringId do botão, para <label for>.
disabledInputbooleanfalseDesativa o select.
compareWithInput(a: V, b: V) => booleanObject.isDiz se dois valores são a mesma opção, para valores que são objetos.
virtualInputboolean | 'auto''auto'Renderiza só as linhas visíveis: sempre, nunca, ou auto acima de 200 linhas.
openChangeOutputbooleanEmite quando a lista abre ou fecha.
showMétodo() => voidAbre a lista.
hideMétodo() => voidFecha a lista.
focusMétodo(options?: FocusOptions) => voidMove o foco para o botão.

Todo texto que ele mostra ou anuncia também é um input, então você pode traduzi-lo: selectAllLabel clearAllLabel emptyLabel

NuiOption

Uma opção. O select, o combobox e a paleta de comandos usam todos esse formato.

NuiOption: Propriedades
NomeTipoPadrãoDescrição
valuePropriedadeVO valor definido ao escolhê-la. Qualquer tipo.
labelPropriedadestringO texto mostrado e buscado.
descriptionPropriedadestringTexto secundário abaixo do rótulo.
groupPropriedadestringOpções com o mesmo grupo aparecem sob esse título, em ordem.
keywordsPropriedadestring[]Mais palavras que a busca encontra, como sinônimos ou códigos.
disabledPropriedadebooleanAparece, mas não pode ser escolhida.
childrenPropriedadeNuiOption<V>[]Opções um nível abaixo, que transformam a lista em uma árvore.

NuiOptionTemplate

Coloque-o em um ng-template dentro do componente para desenhar cada linha você mesmo. O contexto contém a opção e a linha dela.

Seletor
ng-template[nuiOptionTemplate]

NuiOptionText

Desenha o rótulo de uma opção com as letras encontradas destacadas, a descrição e o caminho dela, para as suas próprias linhas.

Seletor
[nuiOptionText]
NuiOptionText: Propriedades
NomeTipoPadrãoDescrição
nuiOptionTextInputNuiOptionRow<V>A linha, do contexto do template.