滑块
BoardUI 视觉语言中的精美范围输入 - 中性插入轨道、蓝色渐变选择、浮雕拇指和精确值气泡。使用 Slider 选择一个值,或使用 RangeSlider 选择最小/最大;两者都包括可访问的隐藏输入、拖动行为、键盘控制以及通过 React Aria 的 RTL 支持。
CLI
手动安装
CLI 将组件源(及其内部依赖项)复制到您的项目中并安装任何所需的 npm 包。
npx boardui@latest add slider使用共享 UI 包或自定义导入别名? 配置您的安装路径 在运行 CLI 之前。复制粘贴示例使用默认导入。
最小和最大范围
RangeSlider 渲染两个带标签的拇指。选定的间隔填充在它们之间,每个气泡显示其精确值,并且拇指不能交叉。使用 minValue, maxValue, 和 step 定义允许的范围。
<RangeSlider label="Price range" defaultValue={[200, 800]} minValue={0} maxValue={1000} step={50} formatValue={(value) => currency.format(value)}/>控制值
使用 值 和 onChange 用于实时控制状态。 onChangeEnd 拖动或键盘输入完成后触发,这对于保存值而不用为每个移动发送更新非常有用。
const [volume, setVolume] = useState(40);const [priceRange, setPriceRange] = useState([200, 800]);
<Slider value={volume} onChange={setVolume} />
<RangeSlider value={priceRange} onChange={setPriceRange} onChangeEnd={(range) => saveRange(range)}/>价值泡沫和状态
默认情况下,精确值气泡是可见的。将它们格式化为 formatValue,或设置 showTooltip=false 当该值已经出现在其他地方时。禁用的滑块保留其值和可访问的标签,同时阻止输入。
<Slider defaultValue={64} />
{/* Hide the exact-value bubble when the surrounding UI shows the value */}<Slider defaultValue={36} showTooltip={false} />
<RangeSlider defaultValue={[20, 70]} isDisabled />