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

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

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

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

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

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

יחסי תלות

הטמעת מתג

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

תוצאות

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

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

תוצאות

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

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

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

תוצאות

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

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

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

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

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

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

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

יש לכם שאלות או משוב

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

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