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

Toggle group

مجموعة أزرار تبديل تتيح التحديد المفرد أو المتعدد مع تركيز متنقّل.

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

المختبر

Toggle group

Single

Multiple

API

ToggleGroup

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

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

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

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

يستخدم radiogroup أصلية ذات تسمية للتحديد المفرد، أو group للتحديد المتعدد. استخدم ToggleGroupClient لسلوك value/onValueChange المتحكّم به.

نقاط التنسيق

data-statedata-disabled
تُرجمت هذه الصفحة آليًا ولم تُراجع بعد.