Select

Eine Pill, die eine Liste auf der Menüfläche öffnet: ein Haken am gewählten Eintrag, Gruppen, Tippsuche.

Log retention

import { Select } from "@logicplanes/kaeso-ui";

Props

appearance
"ghost" | "default" | "header"
Ein gefülltes Feld (default), ein zurückhaltendes für Werkzeugleisten (ghost) oder ein zurückhaltendes in voller Textfarbe für Spaltenköpfe (header).
aria-label
string
Der zugängliche Name, wenn es keine sichtbare Beschriftung gibt.
defaultValue
string | string[] | null
Der Wert beim ersten Rendern, wenn die Komponente ihren Wert selbst verwaltet.
description
ReactNode
Ein Satz Hilfe unter der Beschriftung.
disabled
boolean
Schaltet es aus: Es lässt sich nicht verwenden und wirkt abgeblendet.
fullWidth
boolean
Breite des Auslösers: folgt dem Inhalt (Standard) oder füllt den Container.
icon
IconSvgElement
Führendes Symbol im Auslöser.
id
string
Die ID des Steuerelements, damit eine Beschriftung an anderer Stelle darauf verweisen kann.
invalid
boolean
Zeigt es als ungültig; zusammen mit einer Nachricht, die sagt, was zu korrigieren ist.
label
ReactNode
Die sichtbare Beschriftung.
layout
"horizontal" | "vertical"
Die Beschriftung über dem Steuerelement (vertical) oder daneben (horizontal).
multiple
boolean
Erlaubt die Wahl mehrerer Optionen; value ist dann eine Liste.
name
string
Der Feldname, unter dem der Wert mit einem Formular gesendet wird.
onOpenChange
((open: boolean) => void)
Wird aufgerufen, wenn die Liste geöffnet oder geschlossen wird.
onValueChange
((value: string) => void) | ((value: string[]) => void)
Wird mit dem gewählten Wert aufgerufen, mit multiple mit der Liste der Werte.
open
boolean
Ob die Liste geöffnet ist, bei gesteuertem Zustand.
optional
boolean
Ergänzt die Beschriftung um „Optional“, für Formulare, in denen die meisten Felder Pflicht sind.
options
SelectOption[]
Die Optionen zur Auswahl.
placeholder
ReactNode
Standardmäßig „Auswählen“ in der Sprache des LocaleProvider.
required
boolean
Markiert es in einem Formular als Pflichtfeld.
size
"md" | "sm" | "lg" | "xl"
Die Höhe des Felds.
value
string | string[] | null
Der gewählte Wert, mit multiple eine Liste von Werten, bei gesteuertem Wert.