Import
import { type NuiOption, NuiSelect } from '@needless-ui/angular/select';NuiSelect
Un bouton qui ouvre une liste d’options.
| Nom | Type | Par défaut | Description |
|---|---|---|---|
optionsInput | NuiOption<V>[] | Les options, sous forme d’objets NuiOption. | |
valueBidirectionnel | V | null | null | La valeur choisie, ou null. Fonctionne aussi avec les formulaires. |
valuesBidirectionnel | readonly V[] | [] | Les valeurs choisies, avec multiple. |
multipleInput | boolean | false | Permet de choisir plusieurs options. La liste reste ouverte pendant la sélection. |
selectAllInput | boolean | false | Avec multiple, ajoute un bouton qui coche ou décoche toutes les options. |
placeholderInput | string | 'Select…' | Texte affiché tant que rien n’est choisi. |
labelInput | string | Nom accessible, quand aucun <label> ne nomme le bouton. | |
triggerIdInput | string | Id du bouton, pour <label for>. | |
disabledInput | boolean | false | Désactive le select. |
compareWithInput | (a: V, b: V) => boolean | Object.is | Indique si deux valeurs correspondent à la même option, pour les valeurs qui sont des objets. |
virtualInput | boolean | 'auto' | 'auto' | Ne rend que les lignes visibles : toujours, jamais, ou auto au-delà de 200 lignes. |
openChangeOutput | boolean | Émet quand la liste s’ouvre ou se ferme. | |
showMéthode | () => void | Ouvre la liste. | |
hideMéthode | () => void | Ferme la liste. | |
focusMéthode | (options?: FocusOptions) => void | Place 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.
| Nom | Type | Par défaut | Description |
|---|---|---|---|
valuePropriété | V | La valeur définie par son choix. De n’importe quel type. | |
labelPropriété | string | Le texte affiché et recherché. | |
descriptionPropriété | string | Texte secondaire sous le libellé. | |
groupPropriété | string | Les 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é | boolean | Affiché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.
NuiOptionText
Dessine le libellé d’une option avec les lettres trouvées surlignées, sa description et son chemin, pour vos propres lignes.
| Nom | Type | Par défaut | Description |
|---|---|---|---|
nuiOptionTextInput | NuiOptionRow<V> | La ligne, issue du contexte du template. |