Autocomplete

Chỉ mở dropdown khi người dùng đang gõ — không mở khi click hay focus.

Cài đặt

Import

Cơ bản

Với icon

Controlled

Đã chọn:

Loading

Custom empty text

Clear on select

Input tự xoá sau khi chọn — phù hợp với luồng tag picker hoặc search-and-add.

API Reference

PropTypeDefaultMô tả
options*{ label: string; value: string; description?: string }[]Danh sách lựa chọn
valuestringGiá trị đang chọn (controlled)
defaultValuestringGiá trị khởi tạo cho uncontrolled usage
onValueChange(value: string) => voidCallback khi người dùng chọn một option
labelstringLabel hiển thị phía trên input
placeholderstringPlaceholder text
leftIconReactNodeIcon hiển thị bên trái input
emptyTextstring"No results found."Text hiển thị khi không có kết quả khớp
clearOnSelectbooleanfalseXoá nội dung input ngay sau khi chọn option (hữu ích khi dùng như tag picker hoặc search-and-add)
clearValuestring | nullnullGiá trị emit qua onValueChange khi người dùng nhấn nút xoá. Mặc định emit chuỗi rỗng ("") để React Hook Form nhận được value hợp lệ
isLoadingbooleanHiển thị spinner khi đang tải dữ liệu
classNamestringClass CSS tuỳ chỉnh cho wrapper