Toolbar
קבוצת פקדים עם תחנת Tab אחת וניווט באמצעות מקשי החצים.
- דפדפנים
- Chrome 123+Firefox 121+Safari 17.5+
- שכבה
- 1
- גודל חבילה דחוסה
- 2.45 kB
- מגבלת פריסה כפויה
- 0 ms
- מגבלת Axe
- 0
- תואם SSR
- כן
- חוזה מפורסם
- סביבת בדיקות
מגרש ניסויים
API
Toolbar.Root
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
dir | "ltr" | "rtl" | — | כיוון הכתיבה, ההופך את פעולות מקשי החצים שמאלה וימינה. |
loop | boolean | true | קובע אם הניווט במקשי החצים עובר במחזוריות בין הפריט הראשון לאחרון. |
orientation | "horizontal" | "vertical" | "both" | "horizontal" | מקשי החצים שמעבירים את המיקוד בין הפריטים, והערך של data-orientation. |
Toolbar.Button
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
ref / native props | native element props | — | המאפיינים, הסגנונות, האירועים וה-ref של האלמנט המובנה מועברים הלאה. |
selected | boolean | — | מצב ההחלפה של הכפתור: מגדיר aria-pressed וכשהערך true גם data-selected ואת הרקע הראשי המלא. |
children | ReactNode | — | תוכן הכפתור. |
className | string | — | המחלקה המוחלת על אלמנט הכפתור. |
disabled | boolean | false | משבית את הכפתור ומוציא אותו מסדר הניווט במיקוד נודד. |
Toolbar.Link
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
ref / native props | native element props | — | המאפיינים, הסגנונות, האירועים וה-ref של האלמנט המובנה מועברים הלאה. |
children | ReactNode | — | תוכן הקישור. |
className | string | — | המחלקה המוחלת על אלמנט הקישור. |
href* | string | — | יעד הקישור, המאפשר ניווט ללא JavaScript. |
Toolbar.Separator
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
ref / native props | native element props | — | המאפיינים, הסגנונות, האירועים וה-ref של האלמנט המובנה מועברים הלאה. |
className | string | — | המחלקה המוחלת על אלמנט ה-<hr>. |
orientation | "horizontal" | "vertical" | "vertical" | מגדיר aria-orientation ו-data-orientation על המפריד. |
Toolbar.ToggleGroup
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
id* | string | — | בסיס למזהים הדטרמיניסטיים ולשם המשותף של קבוצת הקלטים. |
type | "single" | "multiple" | "single" | קובע אם ניתן ללחוץ על כפתור החלפה אחד או כמה, באמצעות בחירה בין קלטי רדיו לתיבות סימון. |
items* | readonly ToggleGroupItem[] | — | כל פריט הוא { value, label, disabled? }. |
defaultValue | string | readonly string[] | undefined | — | הערך הלחוץ בהצגה הראשונה. אינו מבוקר, ולכן נשמר גם ללא JavaScript. |
orientation | "horizontal" | "vertical" | "horizontal" | הכיוון שבו כפתורי ההחלפה מסודרים. |
className | string | — | המחלקה המוחלת על שורש הקבוצה. |
מקלדת
| מקש | פעולה |
|---|---|
| Tab | העברת המיקוד אל הפקד או ממנו |
| Enter / Space | הפעלה כשהפקד ממוקד (פקדים דמויי כפתור) |
נגישות
משתמש ב-HTML סמנטי ככל האפשר. בדקו את הסימון המרונדר במגרש הניסויים — ARIA נוסף רק כאשר האלמנטים המובנים אינם מספיקים.
נקודות חיבור לעיצוב
data-disabled