Button
לחצנים הם רכיבים בסיסיים שמאפשרים למשתמש להפעיל פעולה. יש חמישה סוגי לחצנים. הטבלה הבאה מתארת את של כל אחד מחמשת סוגי הלחצנים, והמקומות שבהם צריך להשתמש אותם.
סוג |
מראה |
המטרה |
---|---|---|
מלא |
רקע רציף עם טקסט מנוגד. |
לחצנים מודגשים. ההגדרות האלה רלוונטיות לפעולות ראשיות באפליקציה, כמו 'שליחה' ולוחצים על 'שמירה'. אפקט הצללית מדגיש את חשיבות הלחצן. |
טונל מלא |
צבע הרקע משתנה בהתאם לפני השטח. |
גם לפעולות ראשיות או משמעותיות. לחצנים מלאים מספקים פונקציות חזותיות יותר של משקל וחליפה, כמו 'הוספה לעגלת הקניות' ו'כניסה'. |
גבוה מהרגיל |
המקום מתבלט באמצעות צל. |
בעל תפקיד דומה ללחצנים טונליים. מגדילים את הגובה כדי לגרום ללחצן לבלוט עוד יותר. |
עם קווי מתאר |
כוללת גבול ללא מילוי. |
לחצנים עם הדגשה בינונית, שמכילים פעולות חשובות אבל לא ראשיות. הם מתאימים היטב עם לחצנים אחרים כדי לציין פעולות חלופיות ומשניות כמו 'ביטול' או 'חזרה'. |
טקסט |
הצגת טקסט ללא רקע או שוליים. |
לחצנים עם דגש נמוך, אידיאליים לפעולות פחות חשובות כמו קישורי ניווט או פונקציות משניות כמו 'מידע נוסף' או 'הצגת פרטים'. |
התמונה הבאה ממחישה את חמשת סוגי הלחצנים ב-Material Design.
פלטפורמת API
onClick
: הפונקציה שנקראה כשהמשתמש לוחץ על הלחצן.enabled
: כשהערך הוא False, הפרמטר הזה גורם ללחצן להופיע לא זמין ולא פעיל.colors
: מופע שלButtonColors
שקובע את הצבעים שבהם נעשה שימוש הלחצן.contentPadding
: המרווח הפנימי בתוך הלחצן.
לחצן מלא
רכיב הלחצן שמולאו משתמש בתוכן הקומפוזבילי הבסיסי Button
. זה כן
מלא בצבע מלא כברירת מחדל. קטע הקוד הבא מדגים איך
להטמיע את הרכיב:
@Composable fun FilledButtonExample(onClick: () -> Unit) { Button(onClick = { onClick() }) { Text("Filled") } }
היישום הזה נראה כך:
![לחצן מלא על רקע סגול עם הכיתוב 'מלא'.](https://developer.android.google.cn/static/develop/ui/compose/images/components/button-filled.png?authuser=0000&hl=he)
לחצן טונלי מלא
רכיב הלחצן הטונלי המלא משתמש בתוכן הקומפוזבילי FilledTonalButton
.
כברירת מחדל, השדה מאוכלס בצבע טונלי.
קטע הקוד הבא מדגים איך מטמיעים את הרכיב:
@Composable fun FilledTonalButtonExample(onClick: () -> Unit) { FilledTonalButton(onClick = { onClick() }) { Text("Tonal") } }
היישום הזה נראה כך:
![לחצן טונלי עם רקע סגול בהיר עם הכיתוב 'מלא'.](https://developer.android.google.cn/static/develop/ui/compose/images/components/button-tonal.png?authuser=0000&hl=he)
לחצן מודגש
רכיב הלחצן המודגש משתמש בתוכן הקומפוזבילי OutlinedButton
. הוא
מופיעה עם מתאר כברירת מחדל.
קטע הקוד הבא מדגים איך מטמיעים את הרכיב:
@Composable fun OutlinedButtonExample(onClick: () -> Unit) { OutlinedButton(onClick = { onClick() }) { Text("Outlined") } }
היישום הזה נראה כך:
![לחצן קווי שקוף עם מסגרת כהה עם הכיתוב 'Outlined'.](https://developer.android.google.cn/static/develop/ui/compose/images/components/button-outlined.png?authuser=0000&hl=he)
לחצן בולט
רכיב הלחצן העליון משתמש בתוכן הקומפוזבילי ElevatedButton
. יש בו
צל שמייצג את אפקט הגובה כברירת מחדל. שימו לב שבשביל
למעשה לחצן קווי עם צל.
קטע הקוד הבא מדגים איך מטמיעים את הרכיב:
@Composable fun ElevatedButtonExample(onClick: () -> Unit) { ElevatedButton(onClick = { onClick() }) { Text("Elevated") } }
היישום הזה נראה כך:
![לחצן בולט עם רקע אפור עם הכיתוב 'גבוה'.](https://developer.android.google.cn/static/develop/ui/compose/images/components/button-elevated.png?authuser=0000&hl=he)
לחצן הטקסט
רכיב לחצן הטקסט משתמש בתוכן הקומפוזבילי TextButton
. עד ללחיצה על הלחצן,
הוא מופיע כטקסט בלבד. כברירת מחדל, אין בה מילוי או קווי מתאר מלאים.
קטע הקוד הבא מדגים איך מטמיעים את הרכיב:
@Composable fun TextButtonExample(onClick: () -> Unit) { TextButton( onClick = { onClick() } ) { Text("Text Button") } }
היישום הזה נראה כך:
![לחצן טקסט עם הכיתוב 'לחצן טקסט'](https://developer.android.google.cn/static/develop/ui/compose/images/components/button-text.png?authuser=0000&hl=he)