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" | — | اتجاه الكتابة، وهو يعكس وظيفتَي سهمَي اليسار واليمين. |
loop | boolean | true | يحدّد إن كان التنقل بالأسهم يلتف بين العنصر الأول والأخير. |
orientation | "horizontal" | "vertical" | "both" | "horizontal" | مفاتيح الأسهم التي تنقل التركيز بين العناصر، وقيمة data-orientation. |
Toolbar.Button
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
selected | boolean | — | حالة تبديل الزر: يعيّن aria-pressed، وعند true يضيف data-selected والتعبئة الرئيسية. |
children | ReactNode | — | محتوى الزر. |
className | string | — | الفئة المطبّقة على عنصر الزر. |
disabled | boolean | false | يعطّل الزر ويخرجه من ترتيب التركيز المتنقّل. |
Toolbar.Link
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
children | ReactNode | — | محتوى الرابط. |
className | string | — | الفئة المطبّقة على عنصر الرابط. |
href* | string | — | وجهة الرابط، ويمكن الانتقال إليها دون JavaScript. |
Toolbar.Separator
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
className | string | — | الفئة المطبّقة على عنصر <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? }. |
defaultValue | string | readonly string[] | undefined | — | القيمة المضغوطة عند أول عرض. غير متحكّم بها، لذا تستمر بالعمل دون JavaScript. |
orientation | "horizontal" | "vertical" | "horizontal" | الاتجاه الذي تُرتّب فيه أزرار التبديل. |
className | string | — | الفئة المطبّقة على جذر المجموعة. |
لوحة المفاتيح
| المفتاح | الإجراء |
|---|---|
| Tab | نقل التركيز إلى عنصر التحكم أو منه |
| Enter / Space | التفعيل عند التركيز (لعناصر التحكم الشبيهة بالأزرار) |
إمكانية الوصول
يستخدم HTML الدلالي متى أمكن. افحص بنية HTML المعروضة في المختبر؛ لا تُضاف ARIA إلا حين لا تكفي العناصر الأصلية.
نقاط التنسيق
data-disabled