ComponentPicker & Select
Bắt đầu nhanh
Import ColorPicker từ entry công khai. Các ví dụ bên dưới thể hiện những kiểu tương tác và cấu hình được hỗ trợ.
component.tsxtsx
import { ColorPicker } from '@underverse-ui/underverse';Ví dụ tương tác
Dùng thử ColorPicker thật, xem mã ví dụ và tra cứu các prop đã được mô tả.
Đang tải ví dụ tương tác…
Tham chiếu
Tham chiếu API
Tra cứu các thuộc tính, kiểu dữ liệu được chấp nhận, giá trị mặc định và lưu ý về hành vi.
Dữ liệu được sinh từ API TypeScript công khai của thư viện. Kiểu dữ liệu, thuộc tính bắt buộc và giá trị mặc định luôn đồng bộ với mã nguồn.
ColorPicker
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
value | Giá trị màu điều khiển (#RRGGBB hoặc rgba). | string | — |
defaultValue | Giá trị ban đầu khi uncontrolled. | string | "#4f46e5" |
onChange | Hàm callback khi màu thay đổi. | (value: string) => void | — |
disabled | Vô hiệu hoá điều khiển. | boolean | false |
withAlpha | Bật tuỳ chọn kênh alpha (độ trong suốt). | boolean | false |
format | Định dạng xuất cho onChange (hex hoặc rgba). | OutputFormat | "hex" |
presets | Bảng màu mẫu để chọn nhanh. | string[] | — |
triggerClassName | Class for the trigger button | string | — |
contentClassName | Class for the popover content panel | string | — |
clearable | Show a clear button to reset to empty | boolean | false |
copyable | Show copy to clipboard button | boolean | true |
size | Size variant of the picker | ColorPickerSize | "md" |
variant | Visual variant of the picker | ColorPickerVariant | "default" |
showRecent | Show recent colors history | boolean | false |
showHarmony | Show color harmony suggestions | boolean | false |
maxRecent | Max recent colors to remember | number | 8 |
borderMode | Mã nguồn chưa cung cấp mô tả bổ sung. | BorderMode | — |
Hướng dẫn sử dụng
Dùng ColorPicker khi lựa chọn có giới hạn nhanh và an toàn hơn nhập tự do. Cần cấu hình rõ locale, giới hạn, giá trị bị vô hiệu hóa và trạng thái xóa.
Trợ năng
Khi dùng ColorPicker, hãy giữ trạng thái focus dễ nhận biết, cung cấp tên truy cập khi cần và kiểm tra bàn phím cùng trình đọc màn hình trong ngữ cảnh thực tế.