דילוג לתוכן
uiify

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? }.
defaultValuestring | undefined—הערך הנבחר בהצגה הראשונה. אינו מבוקר, ולכן נשמר גם ללא JavaScript.
valuestring—הערך המבוקר ב-SegmentedControlClient.
onValueChange(value: string) => void—פונקציית תגובה לשינוי ב-SegmentedControlClient.
disabledbooleanfalseמשבית את כל המקטעים ומסמן את הקבוצה ב-data-disabled.
aria-label / aria-labelledbystring—שם נגיש לקבוצת הרדיו; יש לספק אותו כשאין לקבוצה תווית גלויה.
orientation"horizontal" | "vertical""horizontal"הכיוון שבו המקטעים מסודרים.
fullWidthbooleanfalseמגדיר data-full-width על השורש כדי שהמקטעים יימתחו וימלאו את המכל שלהם.
classNamestring—המחלקה המוחלת על שורש הקבוצה.
slotPropsSegmentedControlSlotProps—מאפיינים מובנים לאלמנטי הפריט, הקלט והתווית שנוצרים; ניתן למקד משבצות חוזרות בפריט לפי ערכו.

מקלדת

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

נגישות

radiogroup מובנה לבחירה יחידה המבוסס על כפתורי רדיו מוסתרים. השתמשו ב-SegmentedControlClient להתנהגות מבוקרת של value/onValueChange.

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

data-partdata-disableddata-full-width
דף זה תורגם אוטומטית וטרם נבדק.