组件Controls
Slider
@mox-hub/ui 组件 · Controls · standby
slider@mox-hub/uiControlsstandbysrc/components/slider.tsx变体演示slider
Props API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| className* | string | ((state: SliderRootState) => string) | — | — |
| defaultValue* | number | readonly number[] | — | — |
| value* | number | readonly number[] | — | — |
| min* | number | 0 | — |
| max* | number | 100 | — |
源码
import { Slider as SliderPrimitive } from "@base-ui/react/slider"
import { cn } from "../lib/utils"
function Slider({
className,
defaultValue,
value,
min = 0,
max = 100,
...props
}: SliderPrimitive.Root.Props) {
// P3-09:标量 value/defaultValue 只渲染一个 thumb;数组(区间)才渲染多个。
const _values = Array.isArray(value)
? value
: value !== undefined
? [value]
: Array.isArray(defaultValue)
? defaultValue
: defaultValue !== undefined
? [defaultValue]
: [min]
return (
<SliderPrimitive.Root
className={cn("data-[orientation=horizontal]:w-full data-[orientation=vertical]:h-full", className)}
data-slot="slider"
defaultValue={defaultValue}
value={value}
min={min}
max={max}
thumbAlignment="edge"
{...props}
>
<SliderPrimitive.Control className="relative flex w-full touch-none items-center select-none data-disabled:opacity-50 data-[orientation=vertical]:h-full data-[orientation=vertical]:min-h-40 data-[orientation=vertical]:w-auto data-[orientation=vertical]:flex-col">
<SliderPrimitive.Track
data-slot="slider-track"
className="relative grow overflow-hidden rounded-full bg-muted select-none data-[orientation=horizontal]:h-1.5 data-[orientation=horizontal]:w-full data-[orientation=vertical]:h-full data-[orientation=vertical]:w-1.5"
>
<SliderPrimitive.Indicator
data-slot="slider-range"
className="bg-primary select-none data-[orientation=horizontal]:h-full data-[orientation=vertical]:w-full"
/>
</SliderPrimitive.Track>
{Array.from({ length: _values.length }, (_, index) => (
<SliderPrimitive.Thumb
data-slot="slider-thumb"
key={index}
className="block size-4 shrink-0 rounded-full border border-primary bg-background shadow-xs ring-ring/50 transition-[color,box-shadow] duration-fast select-none hover:ring-4 focus-visible:ring-2 focus-visible:outline-hidden pointer-coarse:after:absolute pointer-coarse:after:-inset-3.5 pointer-coarse:after:rounded-full"
/>
))}
</SliderPrimitive.Control>
</SliderPrimitive.Root>
)
}
export { Slider }
可访问性与 RTL
- 键盘:交互件保留
:focus-visible焦点环;浮层支持 Escape 关闭与焦点归还,菜单 / 页签按 Base UI 约定支持方向键。 筛选菜单、拖拽排序、执行树与模型 listbox 等关键键盘流由 Playwright 断言覆盖,见规范示例 · 交互与可访问性。 - RTL:间距、对齐与方向性图标使用逻辑属性 (
ms-*/text-start/rtl:-scale-x-100);通过ThemeProvider或I18nProvider的direction="rtl"驱动,`lint:rtl` 会拦截新增物理类。 - 文案:优先用组件
labels/translate/translatorprops,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。 - 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。
用法说明
滑块,受控用 value 与 onValueChange,支持区间;需要精确输入时同时提供数值输入框。