フォームと選択@neumorphism-ui/slider

Slider

Base UI Slider を基盤に、単一値と number[] range の API を提供します。配列の各項目につき1つの thumb を作成し、thumbLabels で各 input に名前を付けます。水平・垂直 orientation、制御・非制御の値に対応します。

@neumorphism-ui/slider
Registry JSON

プレビュー

価格帯₩32K – ₩72K
縦方向

インストール

インストール: slidernpx shadcn@latest add @neumorphism-ui/slider

CLI が npm 依存関係、base token、utils、コンポーネントソースを順番に処理します。

この Registry を初めて使う場合は、先に namespace の設定 を完了してください。

使い方

使い方: インストールnpx shadcn@latest add @neumorphism-ui/slider @neumorphism-ui/label

Import

Slider の import コード
import { Slider } from "@/components/ui/slider"
import { Label } from "@/components/ui/label"

Example

Slider の使用コード
<div className="grid gap-3">
  <div className="flex justify-between">
    <Label id="depth-label">深度の強さ</Label>
    <output>64%</output>
  </div>
  <Slider
    defaultValue={[64]}
    min={0}
    max={100}
    step={1}
    aria-labelledby="depth-label"
    thumbLabels={["深度の強さ"]}
  />
</div>

API リファレンス

コンポーネントプロパティ型デフォルト説明
Slidervalue / defaultValuenumber[][min]各 thumb の制御値、または非制御時の初期値です。
Slidermin / maxnumber0 / 100選択可能な数値範囲です。
Sliderstepnumber1キーボードとポインターで調整するときの増分です。
Sliderorientation"horizontal" | "vertical""horizontal"track の向きとキーボード操作の軸を設定します。
SliderthumbLabelsreadonly string[]—実際の thumb input に値の順序で渡すアクセシブルな名前です。
SlideronValueChange / onValueCommitted(value: number | number[]) => void—調整中または調整完了時に値の配列を渡します。
Sliderdisabledbooleanfalseすべての thumb の操作を無効にします。

アクセシビリティ

  • 01

    Slider group には aria-label または aria-labelledby で名前を付け、各 control point の名前を値の順序で thumbLabels に渡してください。

  • 02

    Base UI が各 thumb の role=slider、現在値、最小値、最大値、および Arrow、Page、Home、End キーの動作を管理します。

  • 03

    単一値には1つの thumbLabels 項目を、range には最小値・最大値のように区別できる名前を指定してください。