ComponentForm Input
RadioGroup
RadioGroup thuộc nhóm Form Input. Xem demo trực tiếp, cách tích hợp và các lưu ý triển khai.
Bắt đầu nhanh
Import RadioGroup từ entry của gói Free. 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 { RadioGroup } from '@underverse-ui/underverse';Ví dụ tương tác
Dùng thử RadioGroup 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.
RadioGroup
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
value | Giá trị được chọn. | string | — |
defaultValue | Giá trị ban đầu. | string | — |
onValueChange | Hàm thay đổi (string). | (value: string) => void | — |
name | Tên nhóm input (tự sinh). | string | — |
disabled | Vô hiệu hoá cả nhóm. | boolean | false |
orientation | Ngang/Dọc. | "horizontal" | "vertical" | "vertical" |
size | sm | md | lg. | "sm" | "md" | "lg" | "md" |
variant | default | card | button. | "default" | "card" | "button" | "default" |
borderMode | Mã nguồn chưa cung cấp mô tả bổ sung. | BorderMode | — |
className | Class tuỳ chỉnh. | string | — |
childrenBắt buộc | Mã nguồn chưa cung cấp mô tả bổ sung. | React.ReactNode | Bắt buộc |
required | Bắt buộc. | boolean | false |
error | Trạng thái lỗi. | boolean | false |
errorMessage | Thông báo lỗi. | string | — |
RadioButtonGroup
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
itemsBắt buộc | Mảng (value, label). | Array<{ value: string; label: string; icon?: React.ComponentType<{ className?: string }>; disabled?: boolean; }> | Bắt buộc |
value | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
defaultValue | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
onValueChange | Mã nguồn chưa cung cấp mô tả bổ sung. | (value: string) => void | — |
name | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
disabled | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | false |
size | Mã nguồn chưa cung cấp mô tả bổ sung. | "sm" | "md" | "lg" | "md" |
variant | default | outline | solid. | "default" | "outline" | "solid" | "primary" | "default" |
borderMode | Mã nguồn chưa cung cấp mô tả bổ sung. | BorderMode | — |
className | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
fullWidth | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | false |
RadioGroupItem
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
valueBắt buộc | Giá trị item. | string | Bắt buộc |
id | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
disabled | Vô hiệu hoá item. | boolean | — |
className | Class tuỳ chỉnh. | string | — |
children | Mã nguồn chưa cung cấp mô tả bổ sung. | React.ReactNode | — |
label | Nhãn. | string | — |
labelClassName | Custom class for label | string | — |
description | Mô tả. | string | — |
icon | Icon bên trái. | React.ComponentType<{ className?: string }> | — |
SegmentedControl
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
size | Mã nguồn chưa cung cấp mô tả bổ sung. | "sm" | "md" | "lg" | — |
className | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
disabled | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | — |
fullWidth | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | — |
borderMode | Mã nguồn chưa cung cấp mô tả bổ sung. | BorderMode | — |
name | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
value | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
defaultValue | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
onValueChange | Mã nguồn chưa cung cấp mô tả bổ sung. | (value: string) => void | — |
itemsBắt buộc | Mảng (value, label). | Array<{ value: string; label: string; icon?: React.ComponentType<{ className?: string }>; disabled?: boolean; }> | Bắt buộc |
SimpleRadioGroup
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
itemsBắt buộc | Mảng (value, label). | Array<{ value: string; label: string; description?: string; disabled?: boolean; icon?: React.ComponentType<{ className?: string }>; }> | Bắt buộc |
value | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
defaultValue | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
onValueChange | Mã nguồn chưa cung cấp mô tả bổ sung. | (value: string) => void | — |
name | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
disabled | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | false |
orientation | Mã nguồn chưa cung cấp mô tả bổ sung. | "horizontal" | "vertical" | "vertical" |
size | Mã nguồn chưa cung cấp mô tả bổ sung. | "sm" | "md" | "lg" | "md" |
variant | Mã nguồn chưa cung cấp mô tả bổ sung. | "default" | "card" | "button" | "default" |
borderMode | Mã nguồn chưa cung cấp mô tả bổ sung. | BorderMode | — |
className | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
required | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | false |
error | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | false |
errorMessage | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
ToggleGroup
Component| Thuộc tính | Mô tả | Kiểu | Mặc định |
|---|---|---|---|
size | Mã nguồn chưa cung cấp mô tả bổ sung. | "sm" | "md" | "lg" | — |
className | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
disabled | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | — |
fullWidth | Mã nguồn chưa cung cấp mô tả bổ sung. | boolean | — |
borderMode | Mã nguồn chưa cung cấp mô tả bổ sung. | BorderMode | — |
name | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
value | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
defaultValue | Mã nguồn chưa cung cấp mô tả bổ sung. | string | — |
onValueChange | Mã nguồn chưa cung cấp mô tả bổ sung. | (value: string) => void | — |
itemsBắt buộc | Mảng (value, label). | Array<{ value: string; label: string; icon?: React.ComponentType<{ className?: string }>; disabled?: boolean; }> | Bắt buộc |
Hướng dẫn sử dụng
Kết nối RadioGroup với nhãn hiển thị, thông báo xác thực và trạng thái form rõ ràng. Không dùng placeholder làm nhãn duy nhất.
Trợ năng
Khi dùng RadioGroup, 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ế.