Jetpack Compose מפעיל את המעבדים בשלבים שונים. בפירוט הבא מוצג לאיזה שלב שייכים משתני ה-modifier הנפוצים, ומתי מתבצעת הערכה של הארגומנטים או פונקציות הלמבדה שלהם.
שלב 1: שלב הקומפוזיציה
העיבודים האלה בודקים ארגומנטים באופן סינכרוני בתוך גוף ה-@Composable. כל מצב שנקרא כאן רושם תלות בהיקף ההפעלה מחדש של הרכיב הקומפוזבילי, ומפעיל קומפוזיציה מחדש מלאה כשהוא משתנה.
- משתני שינוי סטטיים של מידות וגדלים:
Modifier.size(dp),Modifier.width(dp),Modifier.height(dp)Modifier.fillMaxSize(),Modifier.fillMaxWidth(),Modifier.fillMaxHeight()Modifier.wrapContentSize(),Modifier.wrapContentWidth(),Modifier.wrapContentHeight()Modifier.requiredSize(),Modifier.defaultMinSize()Modifier.aspectRatio(ratio)Modifier.weight(weight)(RowScopeאוColumnScope)Modifier.width(IntrinsicSize.Min / Max)Modifier.height(IntrinsicSize.Min / Max)
- מרווחים סטטיים ורכיבי Inset:
Modifier.padding(all = dp),Modifier.padding(start, top, end, bottom)Modifier.windowInsetsPadding(insets),Modifier.statusBarsPadding()
- משתנים חזותיים של ערך ישיר:
Modifier.alpha(float)(קורא את המצב במהלך הקומפוזיציה)Modifier.rotate(degrees)(קורא את המצב במהלך הקומפוזיציה)Modifier.scale(scaleX, scaleY)(קורא את המצב במהלך הקומפוזיציה)Modifier.background(color = Color, shape = Shape)Modifier.border(width, color, shape)Modifier.shadow(elevation, shape)Modifier.clip(shape)Modifier.blur(radius)
- משתני מיקום סטטיים:
-
Modifier.offset(x = dp, y = dp)(עומס יתר של ערך ישיר) Modifier.absoluteOffset(x = dp, y = dp)
-
- שינויים קומפוזביליים דינמיים:
Modifier.composed { ... }(מריץ את גוף ה-factory במהלך הקומפוזיציה. לא מומלץ לביצועים – במקום זאת, השתמשו ב-Modifier.Nodeלשינויים מותאמים אישית)
שלב 2: שלב הפריסה
שלב הפריסה מחולק לשני שלבי משנה נפרדים עם היקפי ביטול נפרדים:
שלב 2א: מדידה
קובע את הגודל (width, height) והאילוצים. קריאת המצב כאן מפעילה מדידה מחדש ומיקום מחדש:
-
Modifier.layout { measurable, constraints -> ... }: הקוד שלפניlayout(w, h)מופעל במהלך המדידה.
שלב 2ב: פונקציות קריאה חוזרת (callback) של מיקום ופריסה
קובע את מיקום הקואורדינטה (x, y). קריאת מצב בתוך בלוקים של מיקום מפעילה רק מיקום מחדש (דילוג על מדידה וקומפוזיציה):
Modifier.offset { IntOffset(x, y) }(עומס יתר של פונקציית lambda)Modifier.absoluteOffset { IntOffset(x, y) }(עומס יתר של פונקציית lambda)-
Modifier.layout { ... layout(w, h) { placeable.place(x, y) } }: קוד בתוך הבלוקlayout(w, h) { ... }.
פונקציות קריאה חוזרת (callback) של תצפיות על פריסה פועלות גם במהלך או אחרי שלב הפריסה (הימנעו מכתיבה למצב שנקרא בקומפוזיציה בתוך פונקציות הקריאה החוזרת האלה, כי פעולה כזו גורמת לכתיבה לאחור):
-
Modifier.onSizeChanged { intSize -> ... }: מופעל אחרי שמדידת הפריסה מסתיימת, אם המימדים של הצומת השתנו. -
Modifier.onPlaced { layoutCoordinates -> ... }ו-Modifier.onLayoutRectChanged { ... }: מופעלות אחרי המיקום כדי לדווח על קואורדינטות או גבולות מקומיים בלי להירשם למעברי פריסה גלובליים של חלונות. -
Modifier.onGloballyPositioned { layoutCoordinates -> ... }: מופעל אחרי שכל הפריסה של החלון מסתיימת, בכל פעם שצומת כלשהו זז. כדאי להימנע משימוש ב-onGloballyPositionedכשאפשר, ולהעדיף אתModifier.onVisibilityChangedלמעקב אחרי אזור התצוגה, אתModifier.onPlacedאוModifier.onLayoutRectChangedלגבולות מקומיים, או אתrequireLayoutCoordinates()לפי דרישה בתוךModifier.Node.
שלב 3: שלב הציור
העיבודים האלה מבוצעים במהלך השרטוט ב-Canvas. קריאת המצב בתוך הבלוקים האלה מדלגת על הקומפוזיציה והפריסה, ומריצה רק את שלב השרטוט:
-
Modifier.graphicsLayer { ... }:- המאפיינים שעודכנו ב-lambda:
alpha, translationX, translationY, scaleX, scaleY, rotationX, rotationY, rotationZ, shadowElevation, shape, clip, renderEffect, transformOrigin.
- המאפיינים שעודכנו ב-lambda:
-
Modifier.drawBehind { ... }:- מצייר פקודות קנבס מאחורי התוכן הניתן לשילוב.
-
Modifier.drawWithContent { ... }:- שולטת בסדר הציור באמצעות
drawContent().
- שולטת בסדר הציור באמצעות
-
Modifier.drawWithCache { ... }:- הבלוק החיצוני פועל כשמשנים את הגודל או הפריסה כדי לשמור במטמון אובייקטים מסוג
Path,PaintאוBrush. הבלוקonDrawBehindאוonDrawWithContentפועל בכל פעם שמצויר פריים.
- הבלוק החיצוני פועל כשמשנים את הגודל או הפריסה כדי לשמור במטמון אובייקטים מסוג
מחוץ ללולאת ה-recomposition – משתני תצפית
חלק מהמשתנים פועלים מחוץ לשלושת השלבים של הפריימים כדי לטפל בנגישות, בקלט של המשתמשים ובתצפיות על מחזור החיים.
סמנטיקה ונגישות
מעבד מאפיינים סמנטיים לשירותי נגישות (TalkBack) ולבדיקות:
Modifier.semantics { ... }Modifier.clearAndSetSemantics { ... }
קלט, תנועות ואירועים
פועל מחוץ לצינור עיבוד הנתונים של רינדור הפריימים בשלושה שלבים, ומקבל אירועי תנועה של מערכת ההפעלה ואינטראקציות של משתמשים:
Modifier.pointerInput(key) { detectTapGestures { ... } }/detectDragGestures/awaitPointerEventScopeModifier.clickable(enabled, onClickLabel) { ... }Modifier.combinedClickable { ... }Modifier.toggleable { ... }Modifier.selectable { ... }Modifier.draggable(...)/Modifier.scrollable(...)/Modifier.draggable2D(...)Modifier.onFocusChanged { focusState -> ... }Modifier.onKeyEvent { keyEvent -> ... }-
Modifier.onVisibilityChanged { isVisible -> ... }: הקריאה החוזרת (callback) מופעלת כשסטטוס החשיפה של רכיב Composable משתנה אחרי ההשהיה שהוגדרה, ב-coroutine.
הסבר קצר: שלב הערך לעומת שלב ה-Lambda
קריאת ערך של מצב ב-lambda דוחה את הקריאה לשלב מאוחר יותר, וכך מדלגת על שלבים מוקדמים יותר כשהמצב הזה משתנה:
| משנה / תבנית | ערך ישיר (הרכב) | וריאנט למדא (שלב דחוי) | כשהמצב משתנה |
|---|---|---|---|
| היסט | Modifier.offset(x, y) |
Modifier.offset { IntOffset(x, y) } |
פריסה (מיקום) (דילוג על קומפוזיציה) |
| אלפא / אטימות | Modifier.alpha(alpha) |
Modifier.graphicsLayer { this.alpha = alpha } |
שרטוט (דילוג על קומפוזיציה ופריסה) |
| סיבוב | Modifier.rotate(degrees) |
Modifier.graphicsLayer { rotationZ = degrees } |
שרטוט (דילוג על קומפוזיציה ופריסה) |
| שינוי גודל | Modifier.scale(scale) |
Modifier.graphicsLayer { scaleX = s; scaleY = s } |
שרטוט (דילוג על קומפוזיציה ופריסה) |
| תרגום | Modifier.padding(...) |
Modifier.graphicsLayer { translationX = ... } |
שרטוט (דילוג על קומפוזיציה ופריסה) |
| צבע רקע | Modifier.background(color) |
Modifier.drawBehind { drawRect(color) } |
שרטוט (דילוג על קומפוזיציה ופריסה) |
| גלילה / פרלקס | Modifier.offset(scroll.dp) |
Modifier.offset { IntOffset(0, scroll) } |
פריסה (מיקום) (דילוג על קומפוזיציה) |
מיפוי ממשק Modifier.Node
במשתני שינוי מותאמים אישית שמשתמשים ב-API של Modifier.Node עם ביצועים גבוהים, השלבים ממופים ישירות לממשקי היכולות של הצומת:
| שלב | ממשק Modifier.Node |
שיטות ליבה |
|---|---|---|
| פריסה (מדידה ומיקום) | LayoutModifierNode |
measure(measurable, constraints) |
| פריסה (קואורדינטות גלובליות) | GlobalPositionAwareModifierNode (עדיף requireLayoutCoordinates() על פי דרישה) |
onGloballyPositioned(coordinates) |
| פריסה (מיקום) | LayoutAwareModifierNode |
onRemeasured(size), onPlaced(coordinates) |
| שרטוט | DrawModifierNode |
draw(ContentDrawScope) |
| קלט / סמן | PointerInputModifierNode |
onPointerEvent(...), onCancelPointerInput() |
| סמנטיקה | SemanticsModifierNode |
applySemantics(SemanticsPropertyReceiver) |
| פוקוס | FocusEventModifierNode |
onFocusEvent(focusState) |