ב-Compose, אפשר לשרשר כמה מגדירי שינוי כדי לשנות את המראה והתחושה של רכיב ה-Composable. שרשראות השינויים האלה יכולות להשפיע על האילוצים שמועברים לרכיבים הניתנים לשילוב, שמגדירים את גבולות הרוחב והגובה.
בדף הזה מוסבר איך משתני ה-modifier המשורשרים משפיעים על האילוצים, וכתוצאה מכך על המדידה והמיקום של רכיבי ה-composable.
מגדירי שינוי בעץ של ממשק המשתמש
כדי להבין איך משתני ה-modifier משפיעים זה על זה, כדאי לדמיין איך הם מופיעים בעץ ממשק המשתמש, שנוצר בשלב הקומפוזיציה. מידע נוסף מופיע בקטע הרכב.
בעץ ממשק המשתמש, אפשר להציג את המשנים כצומתי wrapper של צומתי הפריסה:
הוספה של יותר ממאפיין אחד לרכיב Composable יוצרת שרשרת של מאפיינים. כשמשרשרים כמה משתני עיצוב, כל צומת של משתנה עיצוב עוטף את שאר השרשרת ואת צומת הפריסה שבתוכה. לדוגמה, כשמשרשרים משתנה מסוג clip ומשתנה מסוג size, צומת המשתנה clip עוטף את צומת המשתנה size, שעוטף את צומת הפריסה Image.
בשלב הפריסה, האלגוריתם שעובר על העץ נשאר זהה, אבל הוא עובר גם על כל צומת של משתנה. כך, משתנה יכול לשנות את דרישות הגודל והמיקום של המשתנה או של צומת הפריסה שהוא עוטף.
כפי שמוצג בתמונה 2, ההטמעה של הרכיבים הקומפוזביליים Image ו-Text עצמם מורכבת משרשרת של משתני שינוי שעוטפים צומת פריסה יחיד.
ההטמעות של Row ו-Column הן צומתי פריסה שמתארים איך לפרוס את הצאצאים שלהם.
לסיכום:
- מגדירי שינוי עוטפים צומת פריסה או מגדיר שינוי יחיד.
- צומתי פריסה יכולים לפרוס כמה צומתי צאצא.
בקטעים הבאים מוסבר איך להשתמש במודל המנטלי הזה כדי להבין את שרשור השינויים ואיך הוא משפיע על הגודל של רכיבי ה-Composable.
אילוצים בשלב הפריסה
שלב הפריסה פועל לפי אלגוריתם בן שלושה שלבים כדי למצוא את הרוחב, הגובה והקואורדינטות x ו-y של כל צומת פריסה:
- מדידת צאצאים: צומת מודד את הצאצאים שלו, אם יש כאלה.
- החלטה על הגודל: על סמך המידות האלה, הצומת מחליט על הגודל שלו.
- מיקום צאצאים: כל צומת צאצא ממוקם ביחס למיקום של הצומת עצמו.
Constraints עוזרים למצוא את הגדלים המתאימים לצמתים במהלך שני השלבים הראשונים של האלגוריתם. האילוצים מגדירים את הגבולות המינימליים והמקסימליים של הרוחב והגובה של הצומת. כשהצומת קובע את הגודל שלו, הגודל שנמדד צריך להיות בטווח הגדלים הזה.
סוגי מגבלות
אילוץ יכול להיות אחד מהבאים:
- תחום: לצומת יש רוחב וגובה מקסימליים ומינימליים.
- ללא גבולות: הצומת לא מוגבל לגודל מסוים. גבולות הרוחב והגובה המקסימליים מוגדרים כאינסוף.
- מדויק: הצומת מתבקש לפעול לפי דרישת גודל מדויקת. הגבולות המינימליים והמקסימליים מוגדרים לאותו ערך.
- שילוב: הצומת פועל לפי שילוב של סוגי האילוצים הקודמים. לדוגמה, אילוץ יכול להגביל את הרוחב ולאפשר גובה מקסימלי בלתי מוגבל, או להגדיר רוחב מדויק אבל לספק גובה מוגבל.
בקטע הבא מוסבר איך האילוצים האלה עוברים מהורה לצאצא.
איך אילוצים עוברים בירושה מהורה לצאצא
בשלב הראשון של האלגוריתם שמתואר בקטע אילוצים בשלב הפריסה, האילוצים מועברים מההורה לצאצא בעץ ממשק המשתמש.
כשרכיב הורה מודד את רכיבי הצאצא שלו, הוא מספק את האילוצים האלה לכל צאצא כדי להודיע לו מה הגודל המותר שלו. לאחר מכן, כשהוא מחליט על הגודל שלו, הוא גם פועל לפי האילוצים שהועברו על ידי ההורים שלו.
ברמה הכללית, האלגוריתם פועל באופן הבא:
- כדי להחליט מה הגודל שהוא רוצה לתפוס בפועל, צומת הבסיס בעץ ממשק המשתמש מודד את הצאצאים שלו ומעביר את אותן מגבלות לצאצא הראשון שלו.
- אם הצאצא הוא משתנה שלא משפיע על המדידה, הוא מעביר את האילוצים למשתנה הבא. האילוצים מועברים בשרשרת של משני העיצוב כמו שהם, אלא אם מגיעים למשנה עיצוב שמשפיע על המדידה. האילוצים משנים את הגודל שלהם בהתאם.
- כשמגיעים לצומת שאין לו צאצאים (נקרא "צומת עלה"), הוא מחליט על הגודל שלו על סמך האילוצים שהועברו, ומחזיר את הגודל הזה לצומת ההורה שלו.
- ההורה מתאים את האילוצים שלו על סמך המידות של הצאצא הזה, וקורא לצאצא הבא עם האילוצים המותאמים האלה.
- אחרי שכל הצאצאים של צומת הורה נמדדים, צומת ההורה מחליט על הגודל שלו ומעביר את המידע הזה לצומת ההורה שלו.
- כך, כל העץ נסרק קודם כל לעומק. בסופו של דבר, כל הצמתים קובעים את הגדלים שלהם, ושלב המדידה מסתיים.
לדוגמה מפורטת, צפו בסרטון Constraints and modifier order.
גורמים שמשפיעים על האילוצים
בקטע הקודם למדתם שחלק מהמשתנים יכולים להשפיע על גודל האילוץ. בקטעים הבאים מתוארים משתנים ספציפיים שמשפיעים על אילוצים.
המשתנה size
המשתנה size מגדיר את הגודל המועדף של התוכן.
לדוגמה, עץ ממשק המשתמש הבא צריך לעבור עיבוד בקונטיינר בגודל 300dp על 200dp. האילוצים מוגבלים, ומאפשרים רוחב בין 100dp ל-300dp וגובה בין 100dp ל-200dp:
המשתנה size מתאים את האילוצים הנכנסים לערך שמועבר אליו.
בדוגמה הזו, הערך הוא 150dp:
size משנה את האילוצים ל-150dp.אם הרוחב והגובה קטנים מהגבול המינימלי של האילוץ, או גדולים מהגבול המקסימלי של האילוץ, המשתנה יתאים לאילוצים שהועברו בצורה הכי קרובה שאפשר, תוך שמירה על האילוצים שהועברו:
size שמתאים לאילוץ שהועבר בצורה הכי קרובה שאפשר.שימו לב: אי אפשר לשרשר כמה משתני size. המשתנה הראשון size מגדיר גם את האילוץ המינימלי וגם את האילוץ המקסימלי לערך קבוע. גם אם משתנה הגודל השני מבקש גודל קטן או גדול יותר, הוא עדיין צריך לעמוד בגבולות המדויקים שהועברו, כך שהוא לא יבטל את הערכים האלה:
size, שבה הערך השני שהועבר (50dp) לא מבטל את הערך הראשון (100dp).המשתנה requiredSize
אם אתם רוצים שהצומת יבטל את האילוצים הנכנסים, השתמשו ב-modifier requiredSize במקום ב-size. המשתנה requiredSize מחליף את האילוצים הנכנסים ומעביר את הגודל שציינתם כגבולות מדויקים.
אם הגודל שאתם מעבירים חורג מהאילוצים הנכנסים, הצומת מדווח על גודל שמתאים להם כשהגודל מועבר חזרה במעלה העץ, והתוכן שלו ממורכז במרחב הזה בכל ציר שבו שני הגדלים שונים. תוכן שגדול מהמגבלות חורג מהן. באיור 11, requiredSize(50) קטן יותר מ-100dp שמועבר על ידי size, כך שהתוכן של 50dp ממורכז במרחב של 100dp:
requiredSize מבטל את האילוצים הנכנסים מהמשתנה size.המשתנים width ו-height
המשתנה size מתאים גם את הרוחב וגם את הגובה של האילוצים. בעזרת המשתנה width, אתם יכולים להגדיר רוחב קבוע אבל להשאיר את הגובה לא מוגדר.
באופן דומה, באמצעות המשתנה height אפשר להגדיר גובה קבוע, אבל להשאיר את הרוחב לא מוגדר:
width והמשתנה height מגדירים רוחב וגובה קבועים, בהתאמה.כדי להגדיר רוחב או גובה שמבטלים את האילוצים הנכנסים, משתמשים ב-requiredWidth או ב-requiredHeight. כמו requiredSize, כל אחד מהם מחליף את האילוצים הנכנסים, אבל רק בציר שלו: requiredWidth שומר על אילוצי הגובה הנכנסים, ו-requiredHeight שומר על אילוצי הרוחב הנכנסים.
המשתנה sizeIn
המשתנה sizeIn מאפשר להגדיר מגבלות מינימום ומקסימום לרוחב ולגובה, בתוך המגבלות הנכנסות: כשהמגבלות הנכנסות מחמירות יותר, הן גוברות. אם אתם צריכים שליטה מדויקת על האילוצים, השתמשו במשתנה sizeIn. המשתנים widthIn ו-heightIn מבצעים את אותה פעולה בציר אחד ומשאירים את האילוצים של הציר השני ללא שינוי. כל אחד מהם מקבל ערך מינימלי, ערך מקסימלי או את שניהם.
sizeIn עם הערכים minWidth, maxWidth, minHeight ו-maxHeight.כדי להגדיר טווח שמבטל את האילוצים הנכנסים, משתמשים ב-requiredSizeIn או ב-requiredWidthIn וב-requiredHeightIn לציר אחד. הם קשורים ל-sizeIn, ל-widthIn ול-heightIn כמו ש-requiredSize קשור ל-size.
דוגמאות
בקטע הזה מוצג ומוסבר הפלט של כמה קטעי קוד עם משתני שינוי משורשרים.
Image( painterResource(R.drawable.hero), contentDescription = null, Modifier .fillMaxSize() .size(50.dp) )
הפלט של קטע הקוד הזה הוא:
Image ממלא את הגודל המקסימלי כתוצאה משרשרת המגדירים.- המשתנה
fillMaxSizeמשנה את האילוצים כדי להגדיר את הרוחב והגובה המינימליים לערך המקסימלי –300dpברוחב ו-200dpבגובה. - למרות שהמשתנה
sizeרוצה להשתמש בגודל של50dp, הוא עדיין צריך לעמוד באילוצי המינימום הנכנסים. לכן, המשתנהsizeיפיק גם את גבולות האילוץ המדויקים של300על200, ויתעלם מהערך שצוין במשתנהsize. - ה-
Imageפועל לפי הגבולות האלה ומדווח על גודל של300על200, שמועבר עד למעלה בעץ.
Image( painterResource(R.drawable.hero), contentDescription = null, Modifier .fillMaxSize() .wrapContentSize() .size(50.dp) )
הפלט של קטע הקוד הזה הוא:
Image ממורכז והגודל שלו הוא 50dp.- המשתנה
fillMaxSizeמתאים את האילוצים כדי להגדיר את הרוחב והגובה המינימליים לערך המקסימלי –300dpברוחב ו-200dpבגובה. - המשתנה
wrapContentSizeמאפס את האילוצים המינימליים. לכן, בעוד ש-fillMaxSizeגרם לאילוצים קבועים,wrapContentSizeמאפס אותו בחזרה לאילוצים מוגבלים. הצומת הבא יכול עכשיו לתפוס שוב את כל המקום, או להיות קטן יותר מכל המקום. - המשתנה
sizeמגדיר את האילוצים לגבולות המינימום והמקסימום של50. - ה-
Imageנפתר לגודל של50על50, והמשתנהsizeמעביר את זה הלאה. - למשתנה
wrapContentSizeיש מאפיין מיוחד. הוא לוקח את הצאצא שלו וממקם אותו במרכז הגבולות המינימליים הזמינים שהועברו אליו. לכן, הגודל שהוא מעביר להורים שלו שווה לגבולות המינימליים שהועברו אליו.
על ידי שילוב של שלושה משתני שינוי בלבד, אתם יכולים להגדיר גודל לרכיב ה-composable ולמרכז אותו ברכיב ההורה שלו.
Image( painterResource(R.drawable.hero), contentDescription = null, Modifier .clip(CircleShape) .padding(10.dp) .size(100.dp) )
הפלט של קטע הקוד הזה הוא:
- המשתנה
clipלא משנה את האילוצים. - המשתנה
paddingמקטין את האילוצים המקסימליים. - המשתנה
sizeמגדיר את כל האילוצים לערך100dp. - ה-
Imageעומד במגבלות האלה ומדווח על גודל של100dpעל100dp. - המשתנה
paddingמוסיף10dpלכל הצדדים של הגודל שדווח על ידיImage, כך שהפריסה עם המרווח הפנימי מדווחת על רוחב וגובה של120dp. - עכשיו, בשלב השרטוט, המשנה
clipפועל על אזור שרטוט בגודל120dpעל120dp. הוא יוצר מסכה עגולה בגודל הזה. - המשתנה
paddingמוסיף מרווח פנימי של10dpלתוכן שלו מכל הצדדים, וכך מקטין את גודל אזור הציור שלImageל-100dpעל100dp. - ה-
Imageמשורטט בקנבס הקטן יותר. התמונה נחתכת על סמך העיגול המקורי של120dp, כך שהתוצאה היא לא עגולה.
שלושת קטעי הקוד הבאים ממקמים רכיב Box עם צבע רקע באותו מאגר של 300dp על 200dp.
Box( modifier = Modifier .requiredWidth(400.dp) .height(100.dp) .background(Color(0xFF3DDC84)) )
הפלט של קטע הקוד הזה הוא:
requiredWidth(400.dp), ה-Box חורג ב-50dp מכל צד של
המאגר 300dp.- המשתנה
requiredWidthמחליף את אילוצי הרוחב הנכנסים בגבולות מדויקים של400dp. הוא שומר על מגבלות הגובה של הקלט,0עד200dp. - המשתנה
heightמגדיר את הגובה ל-100dp, שמתאים למגבלות הגובה. - המידות של
Boxהן400dpעל100dp. הרוחב הזה גדול מהרוחב של300dpשמותר במאגר, ולכןrequiredWidthמדווח על רוחב של300dpלרכיב ההורה שלו וממרכז את התוכן שלו במרחב הזה:Boxחורג ב-50dpמכל צד של המאגר.
Box( modifier = Modifier .widthIn(min = 100.dp, max = 400.dp) .heightIn(max = 100.dp) .fillMaxSize() .background(Color(0xFF3DDC84)) )
הפלט של קטע הקוד הזה הוא:
widthIn, Box
מודד 300dp על 100dp ונשאר בתוך
המאגר.- המשתנה
widthInמבקש רוחב בין100dpל-400dp. הרוחב המקסימלי של הקלט הוא300dp, ולכן אילוצי הרוחב הופכים ל-100dpעד300dp. - המשתנה
heightInמגדיר גובה מקסימלי של100dp, כך שאילוצי הגובה הופכים ל-0עד100dp. - המשתנה
fillMaxSizeמגדיר את הרוחב והגובה המינימליים לערכי המקסימום האלה, כך שה-Boxהוא300dpעל100dpונשאר בתוך מאגר התגים.
Box( modifier = Modifier .requiredSizeIn(minWidth = 100.dp, maxWidth = 400.dp, maxHeight = 100.dp) .fillMaxSize() .background(Color(0xFF3DDC84)) )
הפלט של קטע הקוד הזה הוא:
requiredSizeIn, ה-Box בגודל 400dp על 100dp ומתרחב
50dp מעבר לכל צד של המאגר, אותה תוצאה כמו באיור
17.- המשתנה
requiredSizeInמחליף את האילוצים הנכנסים ברוחב של100dpעד400dpובגובה של0עד100dp. הגובה המינימלי לא מוגדר, ולכן הוא נשאר הגובה המינימלי הנכנס של0. - המשתנה
fillMaxSizeמגדיר את הרוחב והגובה המינימליים לערכי המקסימום האלה, כך שהמידות שלBoxהן400dpעל100dp. - כמו בדוגמה של
requiredWidth, הרוחב גדול יותר ממה שה-container מאפשר, ולכן ה-Boxממורכז ומתרחב ב-50dpמעבר לכל צד.
באותו טווח, widthIn ו-heightIn שומרים את Box בתוך מאגר התגים, ו-requiredSizeIn לא.