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

Slider

شريط تمرير لاختيار قيمة واحدة أو نطاق بين حدّين.

المتصفحات
Chrome 123+Firefox 121+Safari 17.5+
الفئة
0
الحجم المضغوط
465 B
ميزانية التخطيط القسري
0 ms
ميزانية axe
0
متوافق مع SSR
نعم
العقد المنشور
بيئة الاختبار

المختبر

Slider

شريط تمرير افتراضي

شريط تمرير متحكّم به

شريط تمرير بعلامات

شريط تمرير لنطاق

شريط تمرير عمودي

شريط تمرير معطّل

API

Slider

الخاصيةالنوعافتراضيالوصف
valuenumber—القيمة الحالية، وتجعل شريط التمرير متحكّمًا به.
defaultValuenumber—القيمة الأولية لشريط التمرير غير المتحكّم به، ويتولى مدخل range الأصلي إدارتها بعدها.
onValueChange(value: number) => void—تُستدعى بالعدد الجديد كلما تحرّك شريط التمرير.
minnumber0أدنى قيمة قابلة للاختيار.
maxnumber100أعلى قيمة قابلة للاختيار.
stepnumber1الفارق بين القيم القابلة للاختيار.
disabledbooleanfalseيعطّل المدخل الأصلي ويعيّن سمة data-disabled.
renderReactElement | ((props, state) => ReactElement)—استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول.

SliderClient

الخاصيةالنوعافتراضيالوصف
valuenumber | readonly [number, number]—القيمة المتحكّم بها؛ ويعرض الزوج المرتّب مقبضًا أدنى وآخر أعلى.
defaultValuenumber | readonly [number, number]—القيمة الأولية لمدخل range الأصلي أو النطاق ذي المقبضين.
onValueChange(value: number | readonly [number, number]) => void—تُستدعى عند تغيّر القيمة المحدّدة أو النطاق المرتّب.
minnumber0أدنى قيمة قابلة للاختيار.
maxnumber100أعلى قيمة قابلة للاختيار.
stepnumber | null1تحافظ step الرقمية على التدرّج الأصلي قبل الإماهة؛ وتقيّد null القيم بـ min وmax والعلامات بعد الإماهة.
marksreadonly { value: number; label?: ReactNode }[]—تسميات التدريجات ونقاط الالتقاط حين تكون step مساوية لـ null.
orientation"horizontal" | "vertical""horizontal"اتجاه تخطيط عنصر التحكم وعلاماته.
thumbLabelsreadonly [string, string]—اسمان للتقنيات المساعدة لمقبضي النطاق الأدنى والأعلى.
disabledbooleanfalseيعطّل جميع مدخلات range الأصلية.
renderReactElement | ((props, state) => ReactElement)—استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول.

لوحة المفاتيح

المفتاحالإجراء
Arrow keysتعديل مدخل range الأصلي المركّز بمقدار خطوة أو نقطة توقف واحدة
Home / Endنقل المقبض المركّز إلى الحد الأدنى أو الأقصى
Tabالتنقل بين مقبضي النطاق الأدنى والأعلى

إمكانية الوصول

يعرض Slider مدخل range أصليًا يعمل قبل الإماهة ومع تعطيل JavaScript. يعرض SliderClient أيضًا مدخلات range أصلية على الخادم، ثم يتحكّم بها بعد الإماهة لدعم قيم النطاق والعلامات ذات التسميات والالتقاط غير المنتظم. تحافظ step الرقمية على التدرّج الأصلي قبل الإماهة؛ ويبدأ التقاط العلامات عند step={null} بعد الإماهة. وفّر للشريط المفرد aria-label أو aria-labelledby؛ ووفّر thumbLabels لكلا مقبضي النطاق.

نقاط التنسيق

data-uiify-sliderdata-uiify-slider-clientdata-part="root"data-part="track"data-part="range"data-part="mark"data-part="thumb"data-orientationdata-disableddata-enhanced--uiify-slider-start--uiify-slider-end--uiify-slider-position
تُرجمت هذه الصفحة آليًا ولم تُراجع بعد.