Slider 滑动输入条
通过滑动选择数值或区间。
基础用法
通过滑块选择数值,并为控件提供关联字段名称。
basic.tsx
示例
区间选择
range 使用 [起点, 终点] 二元数组,两个端点不能互相穿越。
range.tsx
离散刻度
marks 提供可点击的刻度。设置 step={null} 后,只能选择刻度中的值。
marks.tsx
只读与禁用
两者都禁止修改;需要仍参与表单提交时使用 readOnly。
disabled.tsx
垂直布局
设置 vertical,沿垂直方向调整数值。
vertical.tsx
数值提示
悬停或聚焦滑块时显示 tooltip,可用 formatter 设置数值格式。
tooltip.tsx
受控值与操作完成
onChange 随数值变化触发,单值返回数字,区间返回二元数组。onChangeComplete 在操作结束且数值发生过变化后触发,可用于保存最终值。重置受控字段时,应用需同步恢复 value。
controlled.tsx
表单与键盘
设置 name 可参与原生表单提交;区间以同一个字段名提交两个值,用 FormData.getAll 读取。非受控字段随表单重置恢复初始值,表单接入见 Form。
方向键按步长调整,Home / End 跳至边界;Shift + 方向键和 PageUp / PageDown 调整十个步长。离散模式按相邻刻度调整。
API
Slider API
配置单值或区间值、数值范围和滑动交互。
SliderMark
在指定数值位置显示刻度与标签。