コンテンツへスキップ

スライダー

値や範囲(音量、価格フィルター、設定など)を選択するためのドラッグ可能な入力フィールドで、ネオブルータリズム風の枠線と影の演出が施されています。

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.json
npx shadcn@latest add https://neobrutalism.com/r/base/slider.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/slider.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/slider.json

次の依存関係をインストールします。

pnpm add @base-ui/react
npm install @base-ui/react
yarn add @base-ui/react
bun add @base-ui/react

次のコードをコピーしてプロジェクトに貼り付けます。

components/ui/slider.tsx
"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-valueminaria-valuemaxaria-valuenow が同期されたフォーカス可能な role="slider" 要素で、フォーム送信用の非表示 input が後ろにあります。スライダー自体に見えるラベルはないため、aria-label または aria-labelledby を渡してください。このラッパーは両方をサム(スクリーンリーダーが実際に読み上げる要素)へ転送します。

キーボード操作:

キー操作
Tab / Shift + Tabサム間、または外へフォーカスを移動
ArrowRight / ArrowUp値を1ステップ増やす
ArrowLeft / ArrowDown値を1ステップ減らす
PageUp / PageDownlargeStep(既定 10)だけ増減
Shift + ArrowlargeStep だけ増減
Home / End最小/最大へジャンプ

RTL では横方向の矢印キーは読み方向に従います。

APIリファレンス

詳しくは Base UI のドキュメントをご覧ください。