Vai al contenuto principale

Panoramica

SearchInput fornisce un’icona di ricerca e un input di testo. onValueChange riceve la nuova stringa; onChange riceve l’evento di modifica React nativo. Il filtraggio, il recupero e il debounce spettano alla tua applicazione.

Utilizzo

Usa aria-label o aria-labelledby per un nome accessibile. Le proprietà dell’input nativo, className, style e ref si applicano all’input stesso. L’InputGroup condiviso gestisce l’elemento decorativo di ricerca e il comportamento del focus. Il wrapper che dispone il campo e le relative azioni non accetta props; inserisci SearchInput nel tuo contenitore per dimensionarlo o posizionarlo. Usa size="sm" per un campo di ricerca compatto.

Azioni

actions visualizza i controlli dopo il campo di ricerca. Crea un popup di filtro con un Dropdown il cui trigger è un IconButton e assegna a tale pulsante un nome accessibile.
disabled disabilita solo l’input di testo; disabilita separatamente i controlli delle azioni. Con size="sm", passa size="sm" anche ai controlli delle azioni.

Props

ReactNode
Controls rendered after the search field, such as a filter Dropdown. Set their size and accessible names on the controls.
string
Accessible name when aria-labelledby is absent.
string
ID of the element that labels the input. Takes precedence over aria-label.
boolean
Focuses the input when mounted.
string | ((state: InputState) => string | undefined)
Class applied to the input.
string | number | readonly string[]
The default value of the input. Use when uncontrolled.
boolean
Disables the text input. Controls in actions keep their own state.
boolean
predefinito:"false"
Shows the group focus border. Defaults to false for all search inputs. Set true to opt in. Error styling remains visible.
string
Input ID, generated when omitted.
((event: BaseUIEvent<ChangeEvent<HTMLInputElement, HTMLInputElement>>) => void)
Native input change event handler.
((value: string, eventDetails: { reason: "none"; event: Event; cancel: () => void; allowPropagation: () => void; isCanceled: boolean; isPropagationAllowed: boolean; trigger: Element | undefined; }) => void)
Called with the new text. The application owns filtering.
string
Hint shown when the input is empty. Also used as the accessible name if no explicit label is supplied.
Ref<HTMLInputElement>
Ref to the native input element.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, InputState>
Allows you to replace the component’s HTML element with a different tag, or compose it with another component.Accepts a ReactElement or a function that returns the element to render.
"md" | "sm"
predefinito:"md"
Visual size of the input group.
CSSProperties | ((state: InputState) => CSSProperties | undefined)
Style applied to the element, or a function that returns a style object based on the component’s state.
"end" | "start"
Aligns text to the logical start or end of the input. Follows the text direction.
string | number | readonly string[]
Current search text.