Salt la conținutul principal

Prezentare generală

SearchInput oferă o pictogramă de căutare și o intrare de text. onValueChange primește noul șir; onChange primește evenimentul React nativ de modificare. Filtrarea, preluarea și eliminarea revenirilor revin aplicației dvs.

Utilizare

Folosiți aria-label sau aria-labelledby pentru un nume accesibil. Proprietățile native ale intrării, className, style și ref se aplică intrării propriu-zise. InputGroup partajat gestionează elementul decorativ de căutare și tratarea focalizării. Învelișul care aranjează câmpul și acțiunile sale nu acceptă props; plasați SearchInput în propriul container pentru a-i stabili dimensiunea sau poziția. Folosiți size="sm" pentru un câmp de căutare compact.

Acțiuni

actions redă controale după câmpul de căutare. Compune o fereastră pop-up de filtrare cu un Dropdown al cărui declanșator este un IconButton și oferă acelui buton un nume accesibil.
disabled dezactivează doar introducerea de text; dezactivează separat controalele de acțiune. Cu size="sm", transmite și controalelor de acțiune size="sm".

Proprietăți

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
implicit:"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"
implicit:"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.