滑块

一个易于自定义样式的范围输入控件。

Volume

安装

pnpm dlx shadcn@latest add @lumi-ui/slider

基本用法

import { Slider } from "@/components/ui/slider"
<Slider />

组件结构

 <Slider />

功能特性

标签

使用 label 属性添加可见的标签。如果滑块没有可见标签,请通过 thumbLabels 为每个滑块手柄提供 aria-label

{/* 可见标签 */}
<Slider label="音量" defaultValue={[50]} />
 
{/* 通过 thumbLabels 提供不可见标签 */}
<Slider thumbLabels={["音量"]} defaultValue={[50]} />
 
{/* 带标签手柄的范围滑块 */}
<Slider
  label="价格范围"
  thumbLabels={["最低价格", "最高价格"]}
  defaultValue={[25, 75]}
/>

尺寸

Default
Small
Large

禁用状态

Disabled

范围滑块

Range Slider
25 – 45

垂直滑块

Vertical Slider

边缘对齐的手柄

使用 thumbAlignment="edge" 让手柄保持在轨道内部。当滑块紧贴容器边缘,或位于带有 overflow: hidden 的父容器中时非常有用。

实用示例

自定义滑块

Price Range

$250 - $750

表单集成

Budget Range

更多信息请参阅 表单集成