הוספת מתג שהמשתמשים יכולים להפעיל או להשבית

רכיב Switch מאפשר למשתמשים לעבור בין שני מצבים: מסומן ולא מסומן. אפשר להשתמש במתג כדי לאפשר למשתמש לבצע אחת מהפעולות הבאות:

• מפעילים או משביתים את ההגדרה.
• מפעילים או משביתים תכונה.
• בוחרים באחת מהאפשרויות.

הרכיב מורכב משני חלקים: האגודל והמסלול. החלק שאפשר לגרור הוא החלק של המתג שאפשר להזיז, והרקע הוא החלק הקבוע של המתג. המשתמש יכול לגרור את האגודל שמאלה או ימינה כדי לשנות את מצב המתג. הם יכולים גם להקיש על המתג כדי לסמן את התיבה ולבטל את הסימון שלה.

תאימות גרסאות

כדי להטמיע את התכונה הזו, צריך להגדיר את minSDK בפרויקט לרמת API‏ 21 ומעלה.

פניות קשורות

הטמעה של מתג

הדוגמה הבאה היא הטמעה מינימלית של ה-composable‏ Switch:

תוצאות

יצירת תמונה ממוזערת בהתאמה אישית

אפשר להעביר כל קומפוזיציה לפרמטר thumbContent כדי ליצור תמונה ממוזערת בהתאמה אישית. הדוגמה הבאה היא של מתג שמשתמש בסמל מותאם אישית עבור הרכיב הנע:

תוצאות

הסימון של התיבה כשהיא לא מסומנת זהה לסימון בדוגמה שבקטע הקודם. עם זאת, כשבודקים את היישום הזה, הוא נראה כך:

שימוש בצבעים בהתאמה אישית

משתמשים בפרמטר colors כדי לשנות את הצבע של האגודל והמסלול של המתג, תוך התחשבות בשאלה אם המתג מסומן.

תוצאות

נקודות עיקריות

• פרמטרים בסיסיים:

  • ‫checked: המצב ההתחלתי של המתג.
  • ‫onCheckedChange: קריאה חוזרת שמופעלת כשהמצב של המתג משתנה.
  • ‫enabled: מצב המתג (מופעל או מושבת).
  • ‫colors: הצבעים שמשמשים למתג.

• פרמטרים מתקדמים

  • ‫thumbContent: משתמשים בזה כדי להתאים אישית את המראה של האגודל כשהוא מסומן.
  • ‫colors: משתמשים באפשרות הזו כדי להתאים אישית את הצבע של הטראק והאגודל.

אוספים שכוללים את המדריך הזה

המדריך הזה הוא חלק מאוספים של מדריכים מהירים שנבחרו בקפידה ועוסקים ביעדים רחבים יותר של פיתוח ל-Android:

יש לך שאלות או משוב?

אפשר לעבור לדף השאלות הנפוצות שלנו כדי לקרוא מדריכים מהירים, או לפנות אלינו ולספר לנו מה דעתך.

מעבר לשאלות הנפוצות שליחת משוב