انتقل إلى المحتوى

المنزلق

احصل على Ritla UI

اختيار قيمة أو نطاق بالسحب أو بلوحة المفاتيح، حين تكون القيمة التقريبية كافية مثل مستوى الصوت أو التكبير أو نطاق السعر.

فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:

افتح في Figma

المعاينة

«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.

المعاينةالكود
إنجليزيمعكوسعربي
← RTL

التثبيت

  1. أضف المكوّن

    npx ritla add slider

    ويعمل أيضًا مع shadcn: npx shadcn@latest add @ritla/slider

  2. الاعتماديات التي يضيفها

    @base-ui/react@phosphor-icons/react

  3. أو انسخه يدويًا

    التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.

الاستخدام

slider.tsx
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]} />

أمثلة

المقاسات

من xs إلى xl: مسار بسماكة 16 و24 و40 و56 و96 بكسل.

إنجليزيمعكوسعربي
← RTL

المقبض الدائري والنقاط

‏handleStyle="circle"، وshowStops يضع نقطة عند كل خطوة حين لا يُسمح إلا بقيم محددة.

إنجليزيمعكوسعربي
← RTL

من المنتصف

يمتلئ من منتصف النطاق نحو القيمة، للقيم التي تنزل تحت الصفر أو تعلوه.

إنجليزيمعكوسعربي
← RTL

نطاق

قيمتان [من، إلى] بمقبضين، وكل مقبض باسمه لقارئ الشاشة.

إنجليزيمعكوسعربي
← RTL

عمودي

يمتلئ من الأسفل في الاتجاهين؛ الأسهم للأعلى والأسفل.

إنجليزيمعكوسعربي
← RTL

معطّل

إنجليزيمعكوسعربي
← RTL

مرجع الخصائص

Slider

الخاصيةالنوعالافتراضيالوصف
size"xs" | "sm" | "md" | "lg" | "xl""xs"خاصية Size: من XSmall إلى XLarge.
handleStyle"line" | "circle""line"خاصية Handle style.
showStopsbooleanfalseخاصية Show stops: نقطة عند كل step. بدونها تبقى نقطة عند نهاية المسار الفارغ.
centeredbooleanfalse‏Centered slider في Figma: يمتلئ من منتصف النطاق.
orientation"horizontal" | "vertical""horizontal"‏Vertical slider في Figma.
value / defaultValuenumber | [number, number]لا يوجدرقم، أو [من، إلى] لـRange slider.
min / max / stepnumber0 / 100 / 1حدود القيمة ومقدار الخطوة.
largeStepnumber10خطوة Page Up وPage Down.
onValueChange / onValueCommitted(value) => voidلا يوجدأثناء السحب، وعند الإفلات.
showValuebooleantrueفقاعة القيمة أثناء السحب أو عند التركيز من لوحة المفاتيح.
formatIntl.NumberFormatOptionsلا يوجدطريقة كتابة القيمة في الفقاعة ولقارئ الشاشة (عملة، نسبة).
numerals"latn" | "arab"لا يوجدنظام الأرقام؛ الافتراضي من RitlaProvider.
disabledbooleanfalse‏State = Disabled.
aria-labelstringلا يوجداسم المنزلق («مستوى الصوت»).

إرشادات الاستخدام

المنزلق لاختيار قيمة تقريبية أو نطاق بالسحب. هنا: أي منزلق تختار، وكيف تعرض القيم، وأي مقاس ومقبض، وما تتحقق منه قبل التسليم.

1. أي منزلق

أربعة منزلقات بالشكل نفسه. اختر حسب ما يُختار. وحين يجب أن تكون القيمة دقيقة، أو توجد خيارات قليلة فقط، فالمنزلق هو العنصر الخطأ.

تحتاج إلىاستخدمالسبب
ضبط قيمة تقريبية واحدة: الصوت، السطوع، ميزانيةالمنزلقيمتلئ من بداية السطر؛ اسحب حتى تشعر أنها مناسبة.
ضبط نطاق: السعر من وإلىمنزلق النطاقمقبضان، والتعبئة تبيّن النطاق.
الضبط حول نقطة محايدة: التوازن، التعريضالمنزلق المتمركزيمتلئ من الوسط نحو السالب أو الموجب.
الصوت أو التكبير في شريط أدوات عموديالمنزلق العمودييمتلئ من الأسفل، بالشكل نفسه في الاتجاهين.
إدخال مبلغ دقيق، مثل تحويلحقل الأرقامكتابة 1,250 أسرع وأدق.
اختيار مستوى من 2 إلى 5 مستويات مسمّاةمجموعة أزرار التبديل أو أزرار الاختيارالخيارات المسمّاة تُقرأ أفضل من المواضع المحددة.

تقريبي لا دقيق

مرشّح سعر، ومبلغ تحويل.

افعل: نطاق لمرشّح السعر«من نحو 20 إلى 80» هو بالضبط ما يحتاجه المرشّح.
تجنّب: منزلق لمبلغ تحويلالوصول إلى 1,250 دينارًا بالسحب شبه مستحيل؛ اكتبه.

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 في الفقاعة، وهو نمط الأرقام في ريتلا.
النص ثنائي الاتجاه
القيمة معزولة في الفقاعة، فتبقى العملة والإشارة في مكانهما.

افعل

  • النسخة العربية لكل منزلق أفقي في الشاشات العربية.
  • تسمية الحد الأدنى على اليمين والأقصى على اليسار.
  • القيم بإعداد الأرقام والوحدات بالعربية.

تجنّب

  • نسخة اليسار إلى اليمين في شاشة عربية، فيمتلئ بالعكس.
  • العكس يدويًا.
  • عكس منزلق عمودي.

الفحوص التي يجتازها

فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.

  • R050نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)