Toggle group
קבוצת כפתורי החלפה עם בחירה יחידה או מרובה ומיקוד נודד.
- דפדפנים
- Chrome 123+Firefox 121+Safari 17.5+
- שכבה
- 0
- גודל חבילה דחוסה
- 1.39 kB
- מגבלת פריסה כפויה
- 0 ms
- מגבלת Axe
- 0
- תואם SSR
- כן
- מבוסס על
- elements/choice
- חוזה מפורסם
- סביבת בדיקות
מגרש ניסויים
API
ToggleGroup
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
id* | string | — | בסיס למזהים הדטרמיניסטיים ולשם המשותף של קבוצת הקלטים. |
type | "single" | "multiple" | "single" | קובע אם ניתן ללחוץ על כפתור החלפה אחד או כמה, באמצעות בחירה בין קלטי רדיו לתיבות סימון. |
items* | readonly ToggleGroupItem[] | — | כל פריט הוא { value, label, disabled? }. |
defaultValue | string | readonly string[] | undefined | — | הערך הלחוץ בהצגה הראשונה. אינו מבוקר, ולכן נשמר גם ללא JavaScript. |
value | string | readonly string[] | — | ערך מבוקר ב-ToggleGroupClient; single משתמש במחרוזת ו-multiple במערך. |
onValueChange | (value) => void | — | פונקציית תגובה לשינוי ב-ToggleGroupClient; לניהול מצב בצד הלקוח יש להשתמש ב-ToggleGroupClient. |
disabled | boolean | false | משבית את כל הפריטים ומסמן את הקבוצה ב-data-disabled. |
aria-label / aria-labelledby | string | — | שם נגיש לקבוצה; יש לספק אותו כשאין לקבוצה תווית גלויה. |
orientation | "horizontal" | "vertical" | "horizontal" | הכיוון שבו כפתורי ההחלפה מסודרים. |
className | string | — | המחלקה המוחלת על שורש הקבוצה. |
slotProps | ToggleGroupSlotProps | — | מאפיינים מובנים לאלמנטי הפריט, הקלט והתווית שנוצרים; ניתן למקד משבצות חוזרות בפריט לפי ערכו. |
מקלדת
| מקש | פעולה |
|---|---|
| Tab | העברת המיקוד לקבוצה |
| Arrow keys | מעבר בין פריטים |
| Space | החלפת מצב הפריט הממוקד |
נגישות
משתמש ב-radiogroup מובנה עם תווית לבחירה יחידה, או ב-group לבחירה מרובה. השתמשו ב-ToggleGroupClient להתנהגות מבוקרת של value/onValueChange.
נקודות חיבור לעיצוב
data-statedata-disabled