הגדרת אופן הפעולה של המאגר

כדי להגדיר את ההתנהגות של קונטיינר 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.

איור של ציר ראשי אופקי.

Start

פריטים שמיושרים לתחילת הציר הראשי.

Center

פריטים שמיושרים למרכז הציר הראשי.

End

פריטים שמוצמדים לסוף הציר הראשי.

SpaceBetween

פריטים שמפוזרים לאורך הציר הראשי עם רווח ביניהם.

SpaceAround

פריטים שמפוזרים לאורך הציר הראשי עם רווח מסביב.

SpaceEvenly

הפריטים מפוזרים לאורך הציר הראשי עם רווח שווה מסביבם.

לאורך הציר הניצב

משתמשים ב-alignItems כדי ליישר פריטים לאורך הציר הניצב בתוך שורה אחת. אפשר לשנות את ההתנהגות הזו לפריטים ספציפיים באמצעות המשנה alignSelf.

בתמונות הבאות מוצגת ההתנהגות כשהכיוון הוא Row:

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

Start

End

Center

Stretch

Baseline

משתמשים בערך alignContent כדי ליישר שורות לציר המשני ולחלק את הרווח הנוסף בין השורות. המאפיין הזה רלוונטי רק כשיש כמה שורות (הגלישה מופעלת). בתמונות הבאות מוצגת ההתנהגות כשכיוון הכתיבה הוא Row:

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

Start

End

Center

Stretch

SpaceBetween

SpaceAround

הצגת הפריטים בכמה שורות

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

ערך FlexWrap

דוגמה לשימוש בתג direction‏ Row

NoWrap (ברירת מחדל): הפריטים לא נשברים לשורה חדשה. אם הגודל הראשי לא מספיק, הפריטים גולשים.

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

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

הפריטים עוברים לשורה חדשה מתחת כי העברת שורה מופעלת.

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

הפריטים עוברים לשורה חדשה למעלה כי האפשרות 'העברה הפוכה לשורה חדשה' מופעלת.

בדוגמה הבאה אפשר לראות איך פועל אלגוריתם העטיפה FlexBox. גודל המאגר FlexBox הוא 100dp, הערך של wrap הוא FlexWrap.Wrap והמרווח הוא 8dp. המאגר מכיל שלושה פריטים עם הערכים basis 20dp, 40dp ו-50dp בהתאמה.

יש 100dp מקומות פנויים בתור. ילד/ה 1 הוא/היא 20dp. יש מקום, ולכן ילד 1 מתווסף לתור.

הפריט הראשון שמוצב בקונטיינר FlexBox.
איור 1. הפריט הראשון הועבר לקונטיינר FlexBox.

יש 80dp מקומות פנויים בתור. הפער הוא 8dp. ילד 2 הוא 40dp. המרחב הנדרש הוא 48dp. יש מקום, ולכן הפער וילד 2 ממוקמים בשורה.

הפריט השני שמוצב במאגר FlexBox אחרי הפריט הראשון.
איור 2. הפריט השני שמוצב בקונטיינר FlexBox אחרי הפריט הראשון.

יש 32dp מקומות פנויים בתור. הפער הוא 8dp. ילד/ה 3 הוא/היא 50dp. המרחב הנדרש הוא 58dp. אין מספיק מקום בשורה הנוכחית, ולכן Child 3 מופיע בשורה חדשה.

הפריט השלישי ממוקם בשורה חדשה כי הוא לא נכנס לשורה הראשונה.
איור 3. הפריט השלישי ממוקם בשורה חדשה כי הוא לא נכנס לשורה הראשונה.

הוספת רווחים בין פריטים

מוסיפים רווחים בין שורות ועמודות באמצעות rowGap ו-columnGap. השיטה הזו שימושית כדי להימנע מהוספת משני ריווח לילדים.

המאפיין row-gap מוסיף רווח אנכי בין הפריטים. המאפיין column gap מוסיף רווח אופקי בין הפריטים. המאפיין Gap מוסיף רווח אופקי ואנכי בין הפריטים.

rowGap

מוסיף רווח אנכי בין פריטים ושורות.

columnGap

מוסיף רווח אופקי בין פריטים ושורות.

gap היא פונקציה נוחה שמוסיפה גם את columnGap וגם את rowGap.