Segmented control
שורת מקטעים לבחירת אפשרות אחת בדיוק.
- דפדפנים
- Chrome 123+Firefox 121+Safari 17.5+
- שכבה
- 0
- גודל חבילה דחוסה
- 1.38 kB
- מגבלת פריסה כפויה
- 0 ms
- מגבלת Axe
- 0
- תואם SSR
- כן
- מבוסס על
- elements/choice
- חוזה מפורסם
- סביבת בדיקות
מגרש ניסויים
API
SegmentedControl
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
size | "sm" | "md" | "lg" | "md" | גובה הפקד וגודל הטקסט, בהתאמה ל-Button (32, 40 או 48 px); נכתבים ל-data-size, עם md כשלא הוגדר ערך. |
id* | string | — | בסיס למזהים הדטרמיניסטיים ולשם המשותף של קבוצת הרדיו. |
items* | readonly SegmentedControlItem[] | — | כל פריט הוא { value, label, disabled? }. |
defaultValue | string | undefined | — | הערך הנבחר בהצגה הראשונה. אינו מבוקר, ולכן נשמר גם ללא JavaScript. |
value | string | — | הערך המבוקר ב-SegmentedControlClient. |
onValueChange | (value: string) => void | — | פונקציית תגובה לשינוי ב-SegmentedControlClient. |
disabled | boolean | false | משבית את כל המקטעים ומסמן את הקבוצה ב-data-disabled. |
aria-label / aria-labelledby | string | — | שם נגיש לקבוצת הרדיו; יש לספק אותו כשאין לקבוצה תווית גלויה. |
orientation | "horizontal" | "vertical" | "horizontal" | הכיוון שבו המקטעים מסודרים. |
fullWidth | boolean | false | מגדיר data-full-width על השורש כדי שהמקטעים יימתחו וימלאו את המכל שלהם. |
className | string | — | המחלקה המוחלת על שורש הקבוצה. |
slotProps | SegmentedControlSlotProps | — | מאפיינים מובנים לאלמנטי הפריט, הקלט והתווית שנוצרים; ניתן למקד משבצות חוזרות בפריט לפי ערכו. |
מקלדת
| מקש | פעולה |
|---|---|
| Tab | העברת המיקוד לקבוצה |
| Arrow keys | מעבר בין מקטעים |
| Space | בחירת המקטע הממוקד |
נגישות
radiogroup מובנה לבחירה יחידה המבוסס על כפתורי רדיו מוסתרים. השתמשו ב-SegmentedControlClient להתנהגות מבוקרת של value/onValueChange.
נקודות חיבור לעיצוב
data-partdata-disableddata-full-width