דילוג לתוכן
uiify

Toggle group

קבוצת כפתורי החלפה עם בחירה יחידה או מרובה ומיקוד נודד.

דפדפנים
Chrome 123+Firefox 121+Safari 17.5+
שכבה
0
גודל חבילה דחוסה
1.39 kB
מגבלת פריסה כפויה
0 ms
מגבלת Axe
0
תואם SSR
כן
מבוסס על
elements/choice
חוזה מפורסם
סביבת בדיקות

מגרש ניסויים

Small
Medium
Large

API

ToggleGroup

מאפייןטיפוסברירת מחדלתיאור
id*string—בסיס למזהים הדטרמיניסטיים ולשם המשותף של קבוצת הקלטים.
type"single" | "multiple""single"קובע אם ניתן ללחוץ על כפתור החלפה אחד או כמה, באמצעות בחירה בין קלטי רדיו לתיבות סימון.
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—המחלקה המוחלת על שורש הקבוצה.
slotPropsToggleGroupSlotProps—מאפיינים מובנים לאלמנטי הפריט, הקלט והתווית שנוצרים; ניתן למקד משבצות חוזרות בפריט לפי ערכו.

מקלדת

מקשפעולה
Tabהעברת המיקוד לקבוצה
Arrow keysמעבר בין פריטים
Spaceהחלפת מצב הפריט הממוקד

נגישות

משתמש ב-radiogroup מובנה עם תווית לבחירה יחידה, או ב-group לבחירה מרובה. השתמשו ב-ToggleGroupClient להתנהגות מבוקרת של value/onValueChange.

נקודות חיבור לעיצוב

data-statedata-disabled
דף זה תורגם אוטומטית וטרם נבדק.