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

Toolbar

مجموعة عناصر تحكم بمحطة Tab واحدة والتنقل بمفاتيح الأسهم.

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

المختبر

Toolbar

افتراضي

API

Toolbar.Root

الخاصيةالنوعافتراضيالوصف
dir"ltr" | "rtl"—اتجاه الكتابة، وهو يعكس وظيفتَي سهمَي اليسار واليمين.
loopbooleantrueيحدّد إن كان التنقل بالأسهم يلتف بين العنصر الأول والأخير.
orientation"horizontal" | "vertical" | "both""horizontal"مفاتيح الأسهم التي تنقل التركيز بين العناصر، وقيمة data-orientation.

Toolbar.Button

الخاصيةالنوعافتراضيالوصف
selectedboolean—حالة تبديل الزر: يعيّن aria-pressed، وعند true يضيف data-selected والتعبئة الرئيسية.
childrenReactNode—محتوى الزر.
classNamestring—الفئة المطبّقة على عنصر الزر.
disabledbooleanfalseيعطّل الزر ويخرجه من ترتيب التركيز المتنقّل.

Toolbar.Link

Toolbar.Separator

الخاصيةالنوعافتراضيالوصف
classNamestring—الفئة المطبّقة على عنصر <hr>.
orientation"horizontal" | "vertical""vertical"يعيّن aria-orientation وdata-orientation على الفاصل.

Toolbar.ToggleGroup

الخاصيةالنوعافتراضيالوصف
id*string—أساس المعرّفات الحتمية والاسم المشترك لمجموعة المدخلات.
type"single" | "multiple""single"يحدّد إمكان ضغط زر تبديل واحد أو عدة أزرار، باختيار مدخلات radio أو checkbox.
items*readonly ToggleGroupItem[]—صيغة كل عنصر هي { value, label, disabled? }.
defaultValuestring | readonly string[] | undefined—القيمة المضغوطة عند أول عرض. غير متحكّم بها، لذا تستمر بالعمل دون JavaScript.
orientation"horizontal" | "vertical""horizontal"الاتجاه الذي تُرتّب فيه أزرار التبديل.
classNamestring—الفئة المطبّقة على جذر المجموعة.

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

المفتاحالإجراء
Tabنقل التركيز إلى عنصر التحكم أو منه
Enter / Spaceالتفعيل عند التركيز (لعناصر التحكم الشبيهة بالأزرار)

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

يستخدم HTML الدلالي متى أمكن. افحص بنية HTML المعروضة في المختبر؛ لا تُضاف ARIA إلا حين لا تكفي العناصر الأصلية.

نقاط التنسيق

data-disabled