شريط تمرير
حقل إدخال قابل للسحب لاختيار قيمة أو نطاق — مثل مستوى الصوت، أو عوامل تصفية الأسعار، أو الإعدادات — مع تطبيق أسلوب «النيوبروتاليست» في تصميم الحدود والظلال.
import { Slider } from "@/components/ui/slider"
export function SliderDemo() {يتيح شريط التمرير للمستخدمين اختيار قيمة — أو نطاق بين مؤشرين — عن طريق السحب على طول المسار. تم بناؤه باستخدام مكون Base UI Slider وتصميمه وفقًا لأسلوب «النيوبروتالية»: حدود سميكة، ومؤشر مربع بظل كثيف، ونطاق مملوء بلون موحد.
استخدمه عندما:
- مستوى الصوت، والسطوع، وموضع التشغيل — مشغلات الوسائط وعناصر التحكم الخاصة بالأجهزة التي يكون فيها السحب أسرع من الكتابة.
- مرشحات السعر والنطاق — يمنحك الماوسان مرشحًا للحد الأدنى والحد الأقصى للبحث وقوائم التجارة الإلكترونية.
- الإعدادات الرقمية ذات الحدود المعقولة — التعتيم، ونصف قطر الحدود، وحجم الخط؛ في أي مكان يكون فيه عرض الرقم المحدود أفضل من كتابته.
التثبيت#
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} />أمثلة#
النطاق#
استخدم مصفوفة بقيمتين لمنزلق نطاق.
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#
لتفعيل RTL في Neobrutalism، راجع دليل إعداد RTL.
"use client"
import * as React from "react"إمكانية الوصول#
يتبع شريط التمرير نمط WAI-ARIA Slider pattern: فكل زر تمرير هو عنصر role="slider" قابل للتركيز، مع الحفاظ على تزامن عناصر aria-valuemin وaria-valuemax وaria-valuenow، مدعومًا بحقل إدخال مخفي لإرسال النموذج. لا يحتوي شريط التمرير على تسمية مرئية خاصة به، لذا قم بتمرير aria-label أو aria-labelledby — حيث يقوم هذا الغلاف بإعادة توجيه كليهما إلى عنصر التمرير، وهو العنصر الذي تعلنه برامج قراءة الشاشة فعليًّا.
تفاعلات لوحة المفاتيح:
| المفتاح | الإجراء |
|---|---|
Tab / Shift + Tab | نقل التركيز بين أزرار التمرير والخروج |
ArrowRight / ArrowUp | زيادة القيمة بمقدار خطوة واحدة |
ArrowLeft / ArrowDown | خفض القيمة بمقدار خطوة واحدة |
PageUp / PageDown | زيادة / خفض بمقدار largeStep (الافتراضي 10) |
Shift + Arrow | زيادة / نقصان بمقدار largeStep |
Home / End | الانتقال إلى الحد الأدنى / الحد الأقصى |
في وضع RTL، تتبع مفاتيح الأسهم الأفقية اتجاه القراءة.
مرجع API#
لمزيد من المعلومات، راجع وثائق Base UI.