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

Segmented control

صف من المقاطع لاختيار خيار واحد فقط.

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

المختبر

Segmented Control

Default

API

SegmentedControl

الخاصيةالنوعافتراضيالوصف
id*string—أساس المعرّفات الحتمية والاسم المشترك لمجموعة أزرار الاختيار.
items*readonly SegmentedControlItem[]—صيغة كل عنصر هي { value, label, disabled? }.
defaultValuestring | undefined—القيمة المحدّدة عند أول عرض. غير متحكّم بها، لذا تستمر بالعمل دون JavaScript.
valuestring—القيمة المتحكّم بها في SegmentedControlClient.
onValueChange(value: string) => void—دالة رد نداء التغيير في SegmentedControlClient.
disabledbooleanfalseيعطّل كل مقطع ويضع data-disabled على المجموعة.
aria-label / aria-labelledbystring—اسم مجموعة radiogroup للتقنيات المساعدة؛ حدّده إن لم توجد تسمية مرئية للمجموعة.
orientation"horizontal" | "vertical""horizontal"الاتجاه الذي تُرتّب فيه المقاطع.
fullWidthbooleanfalseيعيّن data-full-width على الجذر لتتمدد المقاطع وتملأ حاويتها.
classNamestring—الفئة المطبّقة على جذر المجموعة.

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

المفتاحالإجراء
Tabنقل التركيز إلى المجموعة
Arrow keysالتنقل بين المقاطع
Spaceتحديد المقطع المركّز

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

مجموعة radiogroup أصلية للتحديد المفرد مبنية على مدخلات radio مخفية. استخدم SegmentedControlClient لسلوك value/onValueChange المتحكّم به.

نقاط التنسيق

data-partdata-disableddata-full-width
تُرجمت هذه الصفحة آليًا ولم تُراجع بعد.