כדי להגדיר את ההתנהגות של הקונטיינר FlexBox, יוצרים בלוק FlexBoxConfig ומספקים אותו באמצעות הפרמטר config.
FlexBox( config = { direction(FlexDirection.Column) wrap(FlexWrap.Wrap) alignItems(FlexAlignItems.Center) alignContent(FlexAlignContent.SpaceAround) justifyContent(FlexJustifyContent.Center) gap(16.dp) } ) { // child items }
משתמשים ב-FlexBoxConfig כדי להגדיר את כיוון הפריסה, את אופן גלישת הטקסט, את היישור ואת הרווחים בין הפריטים.
כיוון הפריסה
הפונקציה direction מגדירה את הציר הראשי, שקובע את הכיוון שבו הפריטים מסודרים. אפשר להזין בו את הערכים הבאים:
Row(ברירת מחדל): הציר הראשי מוגדר כאופקי. בשפות שנכתבות משמאל לימין, הכיוון יהיה משמאל לימין, ובשפות שנכתבות מימין לשמאל, הכיוון יהיה מימין לשמאל.-
RowReverse: הופך את הכיוון שלRow. -
Column: מגדיר את הציר הראשי כאנכי, מלמעלה למטה. -
ColumnReverse: הופך את הכיוון שלColumn.
יישור פריטים וחלוקת רווחים מיותרים
בקטעים הבאים מוסבר איך ליישר פריטים ולפזר את המרווחים הנוספים לאורך הציר הראשי והציר המשני.
לאורך הציר הראשי
אפשר להשתמש ב-justifyContent כדי לפזר פריטים לאורך הציר הראשי. בטבלה הבאה מוצגת ההתנהגות כשהכיוון הוא Row.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
לאורך הציר הניצב
משתמשים ב-alignItems כדי ליישר פריטים לאורך הציר הנגדי בשורה אחת. אפשר לשנות את ההתנהגות הזו לפריטים ספציפיים באמצעות המשתנה alignSelf.
בתמונות הבאות מוצגת ההתנהגות כשהכיוון הוא Row:
|
|
|
|
|
|
|
|
|
|
|
אפשר להשתמש ב-alignContent כדי ליישר שורות לציר הנגדי ולחלק את המרווח הנוסף בין השורות. המאפיין הזה רלוונטי רק כשיש כמה שורות (גלישת הטקסט מופעלת). בתמונות הבאות מוצגת ההתנהגות כשהכיוון הוא Row:
|
|
|
|
|
|
|
|
|
|
|
|
|
הצגת הפריטים בכמה שורות
גלישת טקסט מאפשרת לקונטיינר FlexBox להפוך למרובה שורות, ולהעביר פריטים שלא מתאימים לשורה או לעמודה חדשה לאורך הציר הנגדי. מגדירים את אופן הפעולה של גלישת הטקסט באמצעות wrap.
ערך |
דוגמה לשימוש בכיוון |
|
|
|
|
|
|
בדוגמה הבאה אפשר לראות איך פועל אלגוריתם העטיפה של FlexBox. הגודל הראשי של מאגר ה-FlexBox הוא 100dp, עם wrap שמוגדר כ-FlexWrap.Wrap ומרווח של 8dp. הוא מכיל שלושה פריטים עם basis 20dp, 40dp ו-50dp, בהתאמה.
יש 100dp מקומות פנויים בתור. הילד הראשון הוא 20dp.
יש מקום, אז הילד הראשון נכנס לתור.
FlexBox.יש 80dp מקומות פנויים בתור. הפער הוא 8dp. הילד השני הוא
40dp. השטח הנדרש הוא 48dp. יש מקום, אז המרווח ו-Child 2 ממוקמים בשורה.
FlexBox אחרי הפריט הראשון.יש 32dp מקומות פנויים בתור. הפער הוא 8dp. הילד השלישי הוא
50dp. השטח הנדרש הוא 58dp. אין מספיק מקום בשורה הנוכחית, ולכן הצאצא השלישי ממוקם בשורה חדשה.
הוספת רווחים בין פריטים
מוסיפים רווחים בין השורות והעמודות באמצעות rowGap ו-columnGap. זה שימושי כדי להימנע מהוספת משתני ריווח לרכיבי הצאצא.
|
|
|
מוסיף רווח אנכי בין פריטים ושורות. |
מוסיף רווח אופקי בין פריטים ושורות. |
|