Import

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

NuiSelect

Un bouton qui ouvre une liste d’options.

Sélecteur
nui-select
NuiSelect: Propriétés
NomTypePar défautDescription
optionsInputNuiOption<V>[]Les options, sous forme d’objets NuiOption.
valueBidirectionnelV | nullnullLa valeur choisie, ou null. Fonctionne aussi avec les formulaires.
valuesBidirectionnelreadonly V[][]Les valeurs choisies, avec multiple.
multipleInputbooleanfalsePermet de choisir plusieurs options. La liste reste ouverte pendant la sélection.
selectAllInputbooleanfalseAvec multiple, ajoute un bouton qui coche ou décoche toutes les options.
placeholderInputstring'Select…'Texte affiché tant que rien n’est choisi.
labelInputstringNom accessible, quand aucun <label> ne nomme le bouton.
triggerIdInputstringId du bouton, pour <label for>.
disabledInputbooleanfalseDésactive le select.
compareWithInput(a: V, b: V) => booleanObject.isIndique si deux valeurs correspondent à la même option, pour les valeurs qui sont des objets.
virtualInputboolean | 'auto''auto'Ne rend que les lignes visibles : toujours, jamais, ou auto au-delà de 200 lignes.
openChangeOutputbooleanÉmet quand la liste s’ouvre ou se ferme.
showMéthode() => voidOuvre la liste.
hideMéthode() => voidFerme la liste.
focusMéthode(options?: FocusOptions) => voidPlace le focus sur le bouton.

Chaque texte qu’il affiche ou annonce est aussi un input, que vous pouvez traduire : selectAllLabel clearAllLabel emptyLabel

NuiOption

Une option. Le select, la combobox et la palette de commandes les acceptent tous.

NuiOption: Propriétés
NomTypePar défautDescription
valuePropriétéVLa valeur définie par son choix. De n’importe quel type.
labelPropriétéstringLe texte affiché et recherché.
descriptionPropriétéstringTexte secondaire sous le libellé.
groupPropriétéstringLes options du même groupe sont listées sous ce titre, dans l’ordre.
keywordsPropriétéstring[]D’autres mots trouvés par la recherche, comme des synonymes ou des codes.
disabledPropriétébooleanAffichée, mais ne peut pas être choisie.
childrenPropriétéNuiOption<V>[]Les options du niveau inférieur, qui transforment la liste en arborescence.

NuiOptionTemplate

Placez-le sur un ng-template dans le composant pour dessiner vous-même chaque ligne. Le contexte contient l’option et sa ligne.

Sélecteur
ng-template[nuiOptionTemplate]

NuiOptionText

Dessine le libellé d’une option avec les lettres trouvées surlignées, sa description et son chemin, pour vos propres lignes.

Sélecteur
[nuiOptionText]
NuiOptionText: Propriétés
NomTypePar défautDescription
nuiOptionTextInputNuiOptionRow<V>La ligne, issue du contexte du template.