Đi tới nội dung tài liệu
Underverse UI Logo
ComponentForm Input

Slider

Slider 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 Slider 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 { Slider } from '@underverse-ui/underverse';

Ví dụ tương tác

Dùng thử Slider 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.

Slider

Component
Thuộc tínhMô tảKiểuMặc định
modeMã nguồn chưa cung cấp mô tả bổ sung."single" | "range""single"
valueGiá trị (controlled).number
defaultValueGiá trị ban đầu (uncontrolled).number0
rangeValueMã nguồn chưa cung cấp mô tả bổ sung.[number, number]
defaultRangeValueMã nguồn chưa cung cấp mô tả bổ sung.[number, number]
minGiá trị nhỏ nhất.number0
maxGiá trị lớn nhất.number100
stepBước nhảy.number1
onChangeHàm thay đổi (number).(value: number) => void
onValueChangeHàm thay đổi alias (number).(value: number) => void
onRangeChangeMã nguồn chưa cung cấp mô tả bổ sung.(value: [number, number]) => void
onRangeValueChangeMã nguồn chưa cung cấp mô tả bổ sung.(value: [number, number]) => void
onMouseUpGọi khi thả chuột.() => void
onTouchEndGọi khi kết thúc chạm.() => void
labelNhãn.React.ReactNode
labelClassNameClass cho nhãn.string
containerClassNameClass cho wrapper.string
trackClassNameClass cho track.string
thumbClassNameClass cho thumb.string
showValueHiển thị giá trị.booleanfalse
valueClassNameClass cho giá trị.string
formatValueĐịnh dạng hiển thị giá trị.(value: number) => string
sizeKích thước slider."sm" | "md" | "lg""md"
disabledVô hiệu hoá.booleanfalse
orientationHướng (ngang/dọc)."horizontal" | "vertical""horizontal"
noFocusBỏ hiệu ứng focus.booleantrue
showTooltipMã nguồn chưa cung cấp mô tả bổ sung.booleantrue
tooltipClassNameMã nguồn chưa cung cấp mô tả bổ sung.string
useGradientMã nguồn chưa cung cấp mô tả bổ sung.booleantrue

Hướng dẫn sử dụng

Kết nối Slider 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 Slider, 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ế.