セクション
コンポーネント
import { Slider } from "@/components/ui/slider"
export function SliderDemo() {Slider は、トラック上をドラッグして値(または2つのサムの間の範囲)を選びます。Base UI Slider コンポーネント上に構築し、ネオブルータリストのレシピに沿ってスタイルしています。太い枠線、硬い影の付いた四角いサム、ソリッドに塗られたレンジです。
次のような場面で使います:
- 音量、明るさ、再生位置 — 入力よりドラッグが向くメディアプレイヤーやデバイス風コントロール。
- 価格と範囲フィルタ — 2つのサムで検索や EC 一覧の min–max フィルタ。
- 妥当な範囲の数値設定 — 不透明度、角丸、フォントサイズなど、境界付きの数を入力より見せたい場面。
インストール#
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/slider.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/slider.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/slider.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/slider.json
次の依存関係をインストールします。
pnpm add @base-ui/reactnpm install @base-ui/reactyarn add @base-ui/reactbun add @base-ui/react
次のコードをコピーしてプロジェクトに貼り付けます。
"use client"
import * as React from "react"
import { Slider as SliderPrimitive } from "radix-ui"
import { cn } from "@/lib/utils"
function Slider({
className,
defaultValue,
value,
min = 0,
max = 100,
// Pulled out of the root spread so they land on the Thumb (the element
// with role="slider" that screen readers announce), not just the Root.
"aria-label": ariaLabel,
"aria-labelledby": ariaLabelledby,
...props
}: React.ComponentProps<typeof SliderPrimitive.Root>) {
const _values = React.useMemo(
() =>
Array.isArray(value)
? value
: Array.isArray(defaultValue)
? defaultValue
: [min, max],
[value, defaultValue, min, max]
)
return (
<SliderPrimitive.Root
data-slot="slider"
defaultValue={defaultValue}
value={value}
min={min}
max={max}
className={cn(
"relative flex w-full touch-none items-center select-none data-disabled:opacity-50 data-vertical:h-full data-vertical:min-h-40 data-vertical:w-auto data-vertical:flex-col",
className
)}
{...props}
>
<SliderPrimitive.Track
data-slot="slider-track"
className="relative grow overflow-hidden border-2 bg-background data-horizontal:h-3 data-horizontal:w-full data-vertical:h-full data-vertical:w-3"
>
<SliderPrimitive.Range
data-slot="slider-range"
className="absolute bg-primary select-none data-horizontal:h-full data-vertical:w-full"
/>
</SliderPrimitive.Track>
{Array.from({ length: _values.length }, (_, index) => (
<SliderPrimitive.Thumb
data-slot="slider-thumb"
key={index}
aria-label={ariaLabel}
aria-labelledby={ariaLabelledby}
className="relative block size-4.5 shrink-0 border-2 bg-background shadow-sm transition-[color,box-shadow] select-none after:absolute after:-inset-2 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50"
/>
))}
</SliderPrimitive.Root>
)
}
export { Slider }
インポートパスをプロジェクトの構成に合わせて調整します。
使い方#
import { Slider } from "@/components/ui/slider"<Slider defaultValue={[33]} max={100} step={1} />使用例#
範囲#
範囲スライダーには、2 つの値を持つ配列を使用します。
import { Slider } from "@/components/ui/slider"
export function SliderRange() {複数のつまみ#
複数のつまみには、複数の値を持つ配列を使用します。
import { Slider } from "@/components/ui/slider"
export function SliderMultiple() {垂直#
垂直方向のスライダーには、orientation="vertical" を指定します。
import { Slider } from "@/components/ui/slider"
export function SliderVertical() {制御された状態#
"use client"
import * as React from "react"無効#
disabled プロパティを使ってスライダーを無効にします。
import { Slider } from "@/components/ui/slider"
export function SliderDisabled() {RTL#
Neobrutalism で RTL を有効にする方法は、RTL 設定ガイドをご覧ください。
"use client"
import * as React from "react"アクセシビリティ#
Slider は WAI-ARIA Slider パターン に従います。各サムは aria-valuemin、aria-valuemax、aria-valuenow が同期されたフォーカス可能な role="slider" 要素で、フォーム送信用の非表示 input が後ろにあります。スライダー自体に見えるラベルはないため、aria-label または aria-labelledby を渡してください。このラッパーは両方をサム(スクリーンリーダーが実際に読み上げる要素)へ転送します。
キーボード操作:
| キー | 操作 |
|---|---|
Tab / Shift + Tab | サム間、または外へフォーカスを移動 |
ArrowRight / ArrowUp | 値を1ステップ増やす |
ArrowLeft / ArrowDown | 値を1ステップ減らす |
PageUp / PageDown | largeStep(既定 10)だけ増減 |
Shift + Arrow | largeStep だけ増減 |
Home / End | 最小/最大へジャンプ |
RTL では横方向の矢印キーは読み方向に従います。
APIリファレンス#
詳しくは Base UI のドキュメントをご覧ください。