AccueilComponentsSelect

Select

Sélecteur d'une ou plusieurs options, nu : on le place dans un FormControl pour son libellé, son aide et sa validation. Le panneau est rendu par le design system sur les deux plateformes : liste déroulante au clavier sur web, bottom sheet sur mobile. Chaque option peut porter une icône, et l’option sélectionnée est signalée par une coche en tête de ligne. Les options partageant un même group sont regroupées sous un en-tête. multiple bascule la valeur de string | null à string[] : le type de onChange suit, sans générique. Le composant reste strictement contrôlé, y compris pour la création d’option : onCreateOption reçoit la saisie, à l’appelant d’ajouter l’option à options puis de mettre value à jour.

Migration depuis Autocomplete

AutocompleteSelect
value: AutocompleteOption[]value: string ou null (mono), string[] (multiple)
isMultimultiple
isSearchablesearchable
disabledFilterSearchlocalFilter={false}
allowEmptyclearable
allowCreatecreatable
onCreateOption(option)onCreateOption(query)
createOptionLabelcreateLabel
createOptionValuesupprimé : l’appelant fabrique l’option
onChange(value, meta)onChange(value) — le second argument disparaît
AutocompleteAddress se recompose avec searchable localFilter={false} creatable : onPlaceSelected devient onChange, onCustomAddress devient onCreateOption, onClear devient onChange(null).
ui
Figma
Ouvrir Figma
(s'ouvre dans un nouvel onglet)
Default
Choisir...
tsx
export const Default = () => {
const [value, setValue] = useState<string | null>(null);
return (
<Box display="flex" flexDirection="column" gap="3W">
<FormControl label="Sélection">
<Select placeholder="Choisir..." options={OPTIONS} value={value} onChange={setValue} />
</FormControl>
</Box>
);
};
States
Option B
Ce champ est requis
Option A
Valide
Option A
tsx
export const States = () => (
<Box display="flex" flexDirection="column" gap="3W">
<FormControl label="Avec valeur">
<Select options={OPTIONS} value="b" />
</FormControl>
<FormControl label="Erreur" error="Ce champ est requis">
<Select options={OPTIONS} value={null} error="Ce champ est requis" />
</FormControl>
<FormControl label="Succès" success="Valide">
<Select options={OPTIONS} value="a" success="Valide" />
</FormControl>
<FormControl label="Désactivé" disabled>
WithIcons
Contact
tsx
export const WithIcons = () => {
const [value, setValue] = useState<string | null>('contact');
return (
<Box display="flex" flexDirection="column" gap="3W">
<FormControl label="Type de ressource">
<Select options={ICON_OPTIONS} value={value} onChange={setValue} />
</FormControl>
</Box>
);
};
Grouped
Tous les types
tsx
export const Grouped = () => {
const [value, setValue] = useState<string | null>(null);
return (
<Box display="flex" flexDirection="column" gap="3W">
<FormControl label="Type de document">
<Select placeholder="Tous les types" options={GROUPED_OPTIONS} value={value} onChange={setValue} />
</FormControl>
</Box>
);
};
LongList
Option 42
tsx
export const LongList = () => {
const [value, setValue] = useState<string | null>('option-42');
return (
<Box display="flex" flexDirection="column" gap="3W">
<FormControl label="Liste défilante">
<Select options={LONG_OPTIONS} value={value} onChange={setValue} />
</FormControl>
</Box>
);
};
Clearable
Option B
tsx
export const Clearable = () => {
const [value, setValue] = useState<string | null>('b');
return (
<Box display="flex" flexDirection="column" gap="3W">
<FormControl label="Effaçable">
<Select placeholder="Choisir..." options={OPTIONS} value={value} onChange={setValue} clearable />
</FormControl>
</Box>
);
};
Searchable
searchable ajoute un champ de recherche au panneau et filtre les options sur leur libellé.
Choisir...
tsx
export const Searchable = () => {
const [value, setValue] = useState<string | null>(null);
return (
<Box display="flex" flexDirection="column" gap="3W">
<FormControl label="Ville">
<Select placeholder="Choisir..." searchable options={CITY_OPTIONS} value={value} onChange={setValue} />
</FormControl>
</Box>
);
};
RemoteSearch
Recherche distante : localFilter={false} laisse le filtrage au serveur, et onSearchChange reçoit la saisie une fois stabilisée. Ici la « requête » est simulée.
Saisir au moins 3 caractères...
tsx
export const RemoteSearch = () => {
const [value, setValue] = useState<string | null>(null);
const [options, setOptions] = useState<SelectOption[]>([]);
const [loading, setLoading] = useState(false);
const search = (query: string) => {
if (query.length < 3) {
setOptions([]);
return;
}
setLoading(true);
setOptions([
Multiple
multiple fait de la valeur un tableau. Les valeurs retenues s’affichent en puces retirables.
Option A
tsx
export const Multiple = () => {
const [values, setValues] = useState<string[]>(['a']);
return (
<Box display="flex" flexDirection="column" gap="3W">
<FormControl label="Sélection multiple">
<Select placeholder="Choisir..." multiple clearable options={OPTIONS} value={values} onChange={setValues} />
</FormControl>
</Box>
);
};
Creatable
creatable propose d’ajouter la saisie à la liste. Le composant restant contrôlé, c’est l’appelant qui insère l’option puis met la valeur à jour.
Rechercher ou créer...
tsx
export const Creatable = () => {
const [options, setOptions] = useState<SelectOption[]>(OPTIONS);
const [values, setValues] = useState<string[]>([]);
const createOption = (query: string) => {
setOptions(current => [...current, { label: query, value: query }]);
setValues(current => [...current, query]);
};
return (
<Box display="flex" flexDirection="column" gap="3W">
<FormControl label="Étiquettes">
Address
Champ adresse : recherche distante et saisie libre autorisée. Ce préréglage remplace l’ancien composant AutocompleteAddress.
ex : 3 rue Robespierre
tsx
export const Address = () => {
const [options, setOptions] = useState<SelectOption[]>([]);
const [value, setValue] = useState<string | null>(null);
const search = (query: string) => {
setOptions(query.length >= 3 ? ADDRESS_SUGGESTIONS : []);
};
const createAddress = (query: string) => {
setOptions(current => [...current, { label: query, value: query }]);
setValue(query);
};
Alveole UI Kit — v2.0.0-alpha.30