מידע על חלונות מוטמעים

פלטפורמת Android אחראית לציור ממשק המשתמש של המערכת, כמו סרגל המצב וסרגל הניווט. ממשק המשתמש של המערכת מוצג בלי קשר לאפליקציה שבה המשתמש משתמש.

‫WindowInsets מספק מידע על ממשק המשתמש של המערכת כדי לוודא שהאפליקציה מציירת באזור הנכון וממשק המשתמש שלה לא מוסתר על ידי ממשק המשתמש של המערכת.

איור 1. האפליקציה נמשכת מקצה לקצה כדי לצייר מאחורי סרגלי המערכת.

ב-Android מגרסה 14 (רמת API 34) ומטה, ממשק המשתמש של האפליקציה לא מוצג מתחת לסרגלי המערכת ולחלקים החסרים במסך כברירת מחדל.

ב-Android 15 (רמת API 35) ומעלה, האפליקציה שלכם מצוירת מתחת לסרגלי המערכת ולחלקים החתוכים של המסך, אחרי שהיא מטרגטת ל-SDK 35. כך אפשר לספק חוויית משתמש חלקה יותר ולאפשר לאפליקציה לנצל באופן מלא את שטח החלון שזמין לה.

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

חשוב: התצוגה מקצה לקצה נאכפת ב-Android מגרסה 15 ומעלה ברגע שהאפליקציה שלכם מטרגטת SDK 35. אם האפליקציה שלכם לא מוצגת מקצה לקצה, יכול להיות שחלקים ממנה יהיו מוסתרים, ותצטרכו לטפל בשוליים הפנימיים. היקף העבודה הנדרשת משתנה מאפליקציה לאפליקציה. רכיב Material 3‏ Scaffold יכול לצמצם את העבודה שנדרשת כדי להשיג תאימות לאכיפה של תצוגה מקצה לקצה ב-Android 15. איך יוצרים רכיב scaffold כדי להחזיק את ממשק המשתמש

יסודות השימוש ב-Inset

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

הגודל של ממשק המשתמש של המערכת ומידע על המיקום שלו מצוינים באמצעות insets.

לכל חלק בממשק המשתמש של המערכת יש סוג תואם של שוליים פנימיים שמתארים את הגודל שלו ואת המיקום שלו. לדוגמה, שוליים פנימיים של שורת הסטטוס מספקים את הגודל והמיקום של שורת הסטטוס, בעוד ששוליים פנימיים של סרגל הניווט מספקים את הגודל והמיקום של סרגל הניווט. כל סוג של שוליים פנימיים מורכב מארבעה מימדים בפיקסלים: top,‏ left,‏ right ו-bottom. המאפיינים האלה מציינים את המרחק שבו ממשק המשתמש של המערכת מתרחב מהצדדים המתאימים של חלון האפליקציה. כדי למנוע חפיפה עם סוג כזה של ממשק משתמש של המערכת, ממשק המשתמש של האפליקציה צריך להיות מוזח פנימה במידה הזו.

סוגי השוליים הפנימיים המובנים האלה ל-Android זמינים דרך WindowInsets:

WindowInsets.statusBars	התמונות הממוזערות שמתארות את שורות הסטטוס. אלה הסרגלים העליונים בממשק המשתמש של המערכת שמכילים סמלי התראות ואינדיקטורים אחרים.
WindowInsets.statusBarsIgnoringVisibility	השוליים הפנימיים של שורת הסטטוס כשהיא גלויה. אם שורות הסטטוס מוסתרות כרגע (בגלל כניסה למצב מסך מלא), אז שוליים פנימיים של שורת הסטטוס הראשית יהיו ריקים, אבל השוליים הפנימיים האלה לא יהיו ריקים.
WindowInsets.navigationBars	השוליים הפנימיים שמתארים את סרגלי הניווט. אלה הם סרגלי ממשק המשתמש של המערכת בצד ימין, שמאל או בתחתית המכשיר, שמתארים את סרגל המשימות או את סמלי הניווט. ההגדרות האלה יכולות להשתנות בזמן הריצה בהתאם לשיטת הניווט המועדפת של המשתמש ולאינטראקציה עם סרגל המשימות.
WindowInsets.navigationBarsIgnoringVisibility	השוליים הפנימיים של סרגל הניווט כשהוא גלוי. אם סרגלי הניווט מוסתרים כרגע (בגלל מעבר למצב מסך מלא), אז שוליים פנימיים של סרגל הניווט הראשי יהיו ריקים, אבל השוליים הפנימיים האלה לא יהיו ריקים.
WindowInsets.captionBar	ההוספה שמתארת את קישוט החלון של ממשק המשתמש של המערכת אם הוא חלון חופשי, כמו סרגל הכותרת העליון.
WindowInsets.captionBarIgnoringVisibility	השוליים הפנימיים של סרגל הכתוביות כשהוא גלוי. אם סרגלי הכתוביות מוסתרים כרגע, אז השוליים הפנימיים של סרגל הכתוביות הראשי יהיו ריקים, אבל השוליים הפנימיים האלה לא יהיו ריקים.
WindowInsets.systemBars	האיחוד של שוליים פנימיים של סרגל המערכת, שכוללים את שורות הסטטוס, סרגלי הניווט וסרגל הכותרת.
WindowInsets.systemBarsIgnoringVisibility	השוליים הפנימיים של סרגל המערכת כשהוא גלוי. אם סרגלי המערכת מוסתרים כרגע (בגלל מעבר למצב מסך מלא), אז השוליים הפנימיים של סרגל המערכת הראשי יהיו ריקים, אבל השוליים הפנימיים האלה לא יהיו ריקים.
WindowInsets.ime	השוליים הפנימיים שמתארים את כמות המקום בתחתית שהמקלדת הווירטואלית תופסת.
WindowInsets.imeAnimationSource	השוליים הפנימיים שמתארים את כמות המקום שהמקלדת הווירטואלית תפסה לפני האנימציה הנוכחית של המקלדת.
WindowInsets.imeAnimationTarget	התמונות הממוזערות מתארות את כמות המקום שהמקלדת הווירטואלית תתפוס אחרי האנימציה הנוכחית של המקלדת.
WindowInsets.tappableElement	סוג של שוליים פנימיים שמתארים מידע מפורט יותר על ממשק המשתמש של הניווט, ומציינים את כמות המרווח שבו המערכת תטפל ב'הקשות', ולא האפליקציה. בסרגלי ניווט שקופים עם ניווט באמצעות מחוות, יכול להיות שיהיה אפשר להקיש על חלק מרכיבי האפליקציה דרך ממשק המשתמש של ניווט המערכת.
WindowInsets.tappableElementIgnoringVisibility	השוליים הפנימיים של הרכיב שאפשר להקיש עליו כשהוא גלוי. אם הרכיבים שאפשר להקיש עליהם מוסתרים כרגע (בגלל מעבר למצב מסך מלא), אז השוליים הפנימיים של הרכיב הראשי שאפשר להקיש עליו יהיו ריקים, אבל השוליים הפנימיים האלה לא יהיו ריקים.
WindowInsets.systemGestures	השוליים הפנימיים שמייצגים את כמות השוליים הפנימיים שבהם המערכת תיירט תנועות לניווט. אפליקציות יכולות לציין באופן ידני טיפול בכמות מוגבלת של המחוות האלה באמצעות Modifier.systemGestureExclusion.
WindowInsets.mandatorySystemGestures	קבוצת משנה של מחוות המערכת שתמיד יטופלו על ידי המערכת, ואי אפשר לבטל את ההסכמה לשימוש בהן דרך Modifier.systemGestureExclusion.
WindowInsets.displayCutout	השוליים הפנימיים שמייצגים את כמות המרווח הנדרשת כדי למנוע חפיפה עם מגרעת במסך (מגרעת או חור קטן).
WindowInsets.waterfall	תמונות מוגדלות שמייצגות את האזורים המעוקלים של מפל. מסך מפלים כולל אזורים מעוקלים לאורך הקצוות של המסך, שבהם המסך מתחיל להתעגל לאורך הצדדים של המכשיר.

הסוגים האלה מסוכמים בשלושה סוגים של מסגרות 'בטוחות' שמוודאות שהתוכן לא מוסתר:

• WindowInsets.safeDrawing
• WindowInsets.safeGestures
• WindowInsets.safeContent

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

• אפשר להשתמש ב-WindowInsets.safeDrawing כדי להגן על תוכן שלא אמור להיות מוצג מתחת לממשק משתמש של מערכת כלשהי. זהו השימוש הנפוץ ביותר ב-insets: למנוע ציור של תוכן שמוסתר על ידי ממשק המשתמש של המערכת (באופן חלקי או מלא).
• אפשר להשתמש ב-WindowInsets.safeGestures כדי להגן על תוכן באמצעות תנועות. כך נמנע מצב שבו מחוות של המערכת מתנגשות עם מחוות של האפליקציה (כמו מחוות של גיליונות תחתונים, קרוסלות או משחקים).
• כדי לוודא שאין חפיפה ויזואלית בין התוכן לבין מחוות, וגם לא חפיפה בין מחוות, אפשר להשתמש ב-WindowInsets.safeContent כשילוב של WindowInsets.safeDrawing ושל WindowInsets.safeGestures.