پرش به محتوا

لغزنده

یک ورودی قابل کشیدن برای انتخاب یک مقدار یا محدوده — حجم، فیلترهای قیمت، تنظیمات — با جلوه‌ی نئوبروتالیستی لبه‌ها و سایه‌ها.

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

export function SliderDemo() {

Slider به کاربران اجازه می‌دهد با کشیدن روی track یک مقدار — یا بازه‌ای بین دو thumb — انتخاب کنند. بر پایهٔ Base UI Slider ساخته شده و با دستور پخت نئوبروتالیستی استایل شده: حاشیه‌های ضخیم، thumb مربعی با سایهٔ سخت، و range پرشدهٔ solid.

برای این موارد از آن استفاده کنید:

  • صدا، روشنایی، موقعیت پخش — media player و کنترل‌های device-style جایی که drag از تایپ بهتر است.
  • فیلتر قیمت و بازه — دو thumb فیلتر min–max برای جستجو و فهرست فروشگاه می‌دهد.
  • تنظیم عددی با کران معقول — opacity، border radius، اندازهٔ فونت؛ هر جا عدد محدود بهتر از تایپ نشان داده شود.

نصب

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} />

نمونه‌ها

بازه

برای یک اسلایدر بازه‌ای از یک آرایه با دو مقدار استفاده کنید.

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

export function SliderRange() {

چند دستگیره

برای چند دستگیره از یک آرایه با چند مقدار استفاده کنید.

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

export function SliderMultiple() {

Vertical

برای یک اسلایدر عمودی از 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

برای فعال‌کردن پشتیبانی از RTL در Neobrutalism، راهنمای پیکربندی RTL را ببینید.

"use client"

import * as React from "react"

دسترسی‌پذیری

Slider از الگوی WAI-ARIA Slider پیروی می‌کند: هر thumb یک عنصر focusable با role="slider" است با aria-valuemin، aria-valuemax و aria-valuenow همگام، پشتش یک input پنهان برای submit فرم. Slider برچسب نمایان خودش ندارد، پس aria-label یا aria-labelledby بدهید — این wrapper هر دو را به thumb که صفحه‌خوان واقعاً اعلام می‌کند forward می‌کند.

تعاملات صفحه‌کلید:

کلیدعمل
Tab / Shift + Tabحرکت فوکوس بین thumbها و خارج
ArrowRight / ArrowUpافزایش مقدار به‌اندازهٔ یک گام
ArrowLeft / ArrowDownکاهش مقدار به‌اندازهٔ یک گام
PageUp / PageDownافزایش / کاهش با largeStep (پیش‌فرض 10)
Shift + Arrowافزایش / کاهش با largeStep
Home / Endپرش به حداقل / حداکثر

در RTL کلیدهای جهت افقی از جهت خواندن پیروی می‌کنند.

مرجع API

مستندات Base UI Slider را ببینید.