Toggle
כפתור שמחליף בין מצב לחוץ למצב לא לחוץ.
- דפדפנים
- Chrome 123+Firefox 121+Safari 17.5+
- שכבה
- 0
- גודל חבילה דחוסה
- 383 B
- מגבלת פריסה כפויה
- 0 ms
- מגבלת Axe
- 0
- תואם SSR
- כן
- חוזה מפורסם
- סביבת בדיקות
מגרש ניסויים
API
Toggle
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
id* | string | — | מזהה קלט תיבת הסימון שהתווית מפנה אליו. |
label* | ReactNode | — | תוכן התווית שלחיצה עליה מחליפה את מצב הקלט. |
pressed | boolean | — | מצב לחיצה מבוקר; אספקתו מעבירה את ניהול המצב לקוד הקורא. |
defaultPressed | boolean | false | מצב הלחיצה בהצגה הראשונה. אינו מבוקר, ולכן פועל גם ללא JavaScript. |
onPressedChange | (pressed: boolean) => void | — | נקראת עם מצב הלחיצה החדש כשכפתור החלפה מבוקר משתנה. |
disabled | boolean | false | משבית את הקלט ומסמן את המעטפת ב-data-disabled. |
className | string | — | המחלקה המוחלת על אלמנט השורש. |
slotProps | ToggleSlotProps | — | מאפיינים מובנים לאלמנטי הפקד והתווית שנוצרים. |
מקלדת
| מקש | פעולה |
|---|---|
| Enter / Space | החלפת המצב הלחוץ בעת מיקוד |
נגישות
אלמנט <button aria-pressed> מובנה (או קלט תיבת סימון מוסתר בווריאציה הקבוצתית). המצב הלחוץ ניתן לקריאה ללא JavaScript.
נקודות חיבור לעיצוב
data-statedata-disabled