المنزلق
اختيار قيمة أو نطاق بالسحب أو بلوحة المفاتيح، حين تكون القيمة التقريبية كافية مثل مستوى الصوت أو التكبير أو نطاق السعر.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add sliderويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/sliderالاعتماديات التي يضيفها
@base-ui/react@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { Slider } from "@/components/ui/slider";<Slider aria-label="Volume" defaultValue={40} /><Slider aria-label="Price" min={0} max={1000} step={50} defaultValue={[200, 800]} />أمثلة
المقبض الدائري والنقاط
handleStyle="circle"، وshowStops يضع نقطة عند كل خطوة حين لا يُسمح إلا بقيم محددة.
من المنتصف
يمتلئ من منتصف النطاق نحو القيمة، للقيم التي تنزل تحت الصفر أو تعلوه.
معطّل
مرجع الخصائص
Slider
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
size | "xs" | "sm" | "md" | "lg" | "xl" | "xs" | خاصية Size: من XSmall إلى XLarge. |
handleStyle | "line" | "circle" | "line" | خاصية Handle style. |
showStops | boolean | false | خاصية Show stops: نقطة عند كل step. بدونها تبقى نقطة عند نهاية المسار الفارغ. |
centered | boolean | false | Centered slider في Figma: يمتلئ من منتصف النطاق. |
orientation | "horizontal" | "vertical" | "horizontal" | Vertical slider في Figma. |
value / defaultValue | number | [number, number] | لا يوجد | رقم، أو [من، إلى] لـRange slider. |
min / max / step | number | 0 / 100 / 1 | حدود القيمة ومقدار الخطوة. |
largeStep | number | 10 | خطوة Page Up وPage Down. |
onValueChange / onValueCommitted | (value) => void | لا يوجد | أثناء السحب، وعند الإفلات. |
showValue | boolean | true | فقاعة القيمة أثناء السحب أو عند التركيز من لوحة المفاتيح. |
format | Intl.NumberFormatOptions | لا يوجد | طريقة كتابة القيمة في الفقاعة ولقارئ الشاشة (عملة، نسبة). |
numerals | "latn" | "arab" | لا يوجد | نظام الأرقام؛ الافتراضي من RitlaProvider. |
disabled | boolean | false | State = Disabled. |
aria-label | string | لا يوجد | اسم المنزلق («مستوى الصوت»). |
إرشادات الاستخدام
المنزلق لاختيار قيمة تقريبية أو نطاق بالسحب. هنا: أي منزلق تختار، وكيف تعرض القيم، وأي مقاس ومقبض، وما تتحقق منه قبل التسليم.
1. أي منزلق
أربعة منزلقات بالشكل نفسه. اختر حسب ما يُختار. وحين يجب أن تكون القيمة دقيقة، أو توجد خيارات قليلة فقط، فالمنزلق هو العنصر الخطأ.
| تحتاج إلى | استخدم | السبب |
|---|---|---|
| ضبط قيمة تقريبية واحدة: الصوت، السطوع، ميزانية | المنزلق | يمتلئ من بداية السطر؛ اسحب حتى تشعر أنها مناسبة. |
| ضبط نطاق: السعر من وإلى | منزلق النطاق | مقبضان، والتعبئة تبيّن النطاق. |
| الضبط حول نقطة محايدة: التوازن، التعريض | المنزلق المتمركز | يمتلئ من الوسط نحو السالب أو الموجب. |
| الصوت أو التكبير في شريط أدوات عمودي | المنزلق العمودي | يمتلئ من الأسفل، بالشكل نفسه في الاتجاهين. |
| إدخال مبلغ دقيق، مثل تحويل | حقل الأرقام | كتابة 1,250 أسرع وأدق. |
| اختيار مستوى من 2 إلى 5 مستويات مسمّاة | مجموعة أزرار التبديل أو أزرار الاختيار | الخيارات المسمّاة تُقرأ أفضل من المواضع المحددة. |
تقريبي لا دقيق
مرشّح سعر، ومبلغ تحويل.
2. القيم والدقة
اعرض القيمة الحالية أثناء السحب (مؤشر القيمة) وبجوار التسمية في السكون. واعرض الحد الأدنى والأقصى حين يهمّان. وحين قد يحتاج الناس إلى قيمة دقيقة، اقرن المنزلق بحقل الأرقام متزامنًا معه. واستخدم المواضع المحددة فقط حين تُسمح قيم قليلة.
افعل
- اعرض القيمة بجوار التسمية مع وحدتها: «من 20 إلى 80 دينارًا».
- اعرض الحد الأدنى والأقصى تحت المسار حين يعطيان سياقًا.
- اقرنه بحقل الأرقام حين تُحتاج قيمة دقيقة أحيانًا.
- اجعله يقفز إلى المواضع المحددة حين تصح قيم محددة فقط.
تجنّب
- إخفاء القيمة الحالية، فيخمّن الناس.
- خطوة دقيقة جدًا يقفز معها المقبض تحت الإصبع.
- مواضع محددة لأكثر من نحو عشر قيم.
3. المقاسات والمقابض
خمسة مقاسات من xs إلى xl بالنسب نفسها. استخدم md في النماذج والمرشّحات، وlg أو xl حيث يعمل الإبهام، وxs وsm فقط في أدوات الحاسوب الكثيفة. والمقبض الخطي هو الافتراضي في Figma وفي الكود، والدائري يُقرأ قابلًا للسحب على شاشات اللمس، فيناسب الجوال.
افعل
- استخدم
mdافتراضيًا، وlgأوxlعلى شاشات اللمس. - ابدأ بالمقبض الخطي، وانتقل إلى الدائري على الجوال.
- مقاس واحد ونمط مقبض واحد في كل شاشة.
تجنّب
- استخدام
xsعلى الهاتف، فالمقبض أصغر من أن يُمسك. - خلط المقبضين الخطي والدائري في لوحة مرشّحات واحدة.
4. العربية والاتجاه من اليمين إلى اليسار
المنزلق الأفقي يمتلئ من بداية السطر، ففي العربية يمتلئ من اليمين إلى اليسار: الحد الأدنى على اليمين، والأقصى على اليسار، وArrowLeft يزيد القيمة. استخدم النسخة العربية، فهي تعكس المسار والتعبئة والنطاق. والمنزلق المتمركز يضع السالب على اليمين. والمنزلق العمودي لا يتغير. والقيم تتبع إعداد الأرقام.
يمتلئ من بداية السطر
إعداد السطوع بالعربية.
قبل التسليم
- المنزلق فقط للقيم التقريبية أو النطاقات.
- التسمية والقيمة الحالية والحدّان مصمّمة.
- الخطوة والمواضع المحددة وأي حقل أرقام مقترن مدوّنة.
- الشاشات العربية تستخدم النسخ العربية، والحد الأدنى على اليمين.
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| ArrowRightArrowUp | يزيد خطوة. في العربية يزيد ArrowLeft. |
| ArrowLeftArrowDown | ينقص خطوة. في العربية ينقص ArrowRight. |
| PageUpPageDown | يزيد أو ينقص بمقدار largeStep. |
| HomeEnd | إلى الحد الأدنى أو الأقصى. |
ARIA
- كل مقبض
role="slider"معaria-valueminوaria-valuemaxوaria-valuenow، ونص القيمة بالتنسيق والأرقام نفسها. - في النطاق يُسمّى المقبضان «…، من» و«…، إلى».
- للمبالغ الدقيقة مثل مبلغ التحويل استخدم حقلًا، أو أضف حقلًا بجانب المنزلق.
افعل
- تسمية لكل منزلق، واسم لكل مقبض في النطاق: «أدنى سعر»، «أعلى سعر».
- الأسهم خطوة واحدة، وPage Up وPage Down عشر خطوات، وHome وEnd الطرفان.
- قيم مقروءة بوحداتها: «35 دينارًا».
- مقبض لا يقل عن 48 بكسل على شاشات اللمس.
تجنّب
- الاكتفاء بلون التعبئة.
- منزلق طريقةً وحيدة لضبط قيمة دقيقة.
ملاحظات العربية والاتجاه
ينعكس
- المنزلق الأفقي يمتلئ من اليمين: الحد الأدنى على اليمين، وArrowLeft يزيد.
- النطاق والمنزلق من المنتصف ينعكسان بالطريقة نفسها.
لا ينعكس
- المنزلق العمودي يمتلئ من الأسفل في اللغتين.
- أيقونة المقبض الدائري متناظرة فلا تنعكس.
- الأرقام
- فقاعة القيمة ونص قارئ الشاشة بنظام الأرقام المختار (
0123456789أو٠١٢٣٤٥٦٧٨٩) وبتنسيق اللغة. - الخط العربي
-
numeric-14بوزن Medium في الفقاعة، وهو نمط الأرقام في ريتلا. - النص ثنائي الاتجاه
- القيمة معزولة في الفقاعة، فتبقى العملة والإشارة في مكانهما.
افعل
- النسخة العربية لكل منزلق أفقي في الشاشات العربية.
- تسمية الحد الأدنى على اليمين والأقصى على اليسار.
- القيم بإعداد الأرقام والوحدات بالعربية.
تجنّب
- نسخة اليسار إلى اليمين في شاشة عربية، فيمتلئ بالعكس.
- العكس يدويًا.
- عكس منزلق عمودي.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.