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

Select

غلاف لعنصر select الأصلي.

المتصفحات
Chrome 135+Firefox 121+
لماذا هذا الإصدار؟

Firefox keeps the native select control. This custom styling uses ::picker(select), :open, and option::checkmark, which Firefox does not support yet.

Safari 17+
لماذا هذا الإصدار؟

Safari keeps the native select control. This custom styling uses ::picker(select), :open, and option::checkmark, which Safari does not support yet.

الفئة
0
الحجم المضغوط
480 B
ميزانية التخطيط القسري
0 ms
ميزانية axe
0
متوافق مع SSR
نعم
العقد المنشور
بيئة الاختبار

المختبر

Select

افتراضي

مجمّع

حيوان أليف

بفواصل

قيمة طويلة

API

Select.Root

الخاصيةالنوعافتراضيالوصف
childrenReactNode—أجزاء Select، وعادة تكون Select.Content تضم عناصر ومجموعات.
valuestring—القيمة المحدّدة، وتجعل قائمة الاختيار متحكّمًا بها.
defaultValuestring—القيمة المحدّدة عند أول عرض؛ يدير select الأصلي التحديد بعدها، لذا يعمل دون JavaScript.
onValueChange(value: string) => void—تُستدعى بالقيمة الجديدة عند تغيّر التحديد.
namestring—اسم حقل النموذج المرسل مع القيمة المحدّدة.
disabledbooleanfalseيعطّل select الأصلي ويعيّن سمة data-disabled.
renderReactElement | ((props, state) => ReactElement)—استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول.

Select.Content

الخاصيةالنوعافتراضيالوصف
childrenReactNode—عناصر ومجموعات وفواصل؛ يعرض الجزء أبناءه دون إضافة عنصر.

Select.Item

الخاصيةالنوعافتراضيالوصف
childrenReactNode—النص المعروض لهذا الخيار.
disabledbooleanfalseيجعل هذا الخيار غير قابل للاختيار.
value*string—القيمة المرسلة عند تحديد هذا الخيار.
renderReactElement | ((props, state) => ReactElement)—استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول.

Select.Group

الخاصيةالنوعافتراضيالوصف
childrenReactNode—العناصر التابعة لهذه المجموعة.
label*string—عنوان المجموعة الذي تعرضه مجموعة الخيارات الأصلية.
renderReactElement | ((props, state) => ReactElement)—استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول.

Select.Separator

الخاصيةالنوعافتراضيالوصف
renderReactElement | ((props, state) => ReactElement)—استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول.

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

المفتاحالإجراء
Arrow keysتغيير الخيار عند التركيز
Spaceفتح المنتقي الأصلي (بحسب المنصة)

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

عنصر أصلي <select> للنص فقط؛ يدير المتصفح التحديد وإدخال لوحة المفاتيح والبحث بالكتابة وإرسال النموذج. ولا تحسّن المحركات الداعمة إلا مظهر المنتقي.

نقاط التنسيق

data-disabled