Jetpack Compose, değiştiricileri farklı aşamalarda yürütür. Aşağıdaki dökümde, yaygın değiştiricilerin hangi aşamaya ait olduğu ve bağımsız değişkenlerinin veya lambda'larının ne zaman değerlendirildiği gösterilmektedir.
1. aşama: Oluşturma aşaması
Bu değiştiriciler, bağımsız değişkenleri @Composable gövdesi içinde eşzamanlı olarak değerlendirir. Burada okunan tüm durumlar, Composable yeniden başlatma kapsamıyla bir bağımlılık kaydeder ve değiştirildiğinde tam bir yeniden oluşturma işlemini tetikler.
- Statik boyut ve boyutlandırma değiştiricileri:
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)(RowScopeveyaColumnScopecinsinden)Modifier.width(IntrinsicSize.Min / Max)Modifier.height(IntrinsicSize.Min / Max)
- Statik Boşluk ve İç Boşluklar:
Modifier.padding(all = dp),Modifier.padding(start, top, end, bottom)Modifier.windowInsetsPadding(insets),Modifier.statusBarsPadding()
- Doğrudan Değer Görsel Değiştiricileri:
Modifier.alpha(float)(oluşturma sırasında durumu okur)Modifier.rotate(degrees)(oluşturma sırasında durumu okur)Modifier.scale(scaleX, scaleY)(oluşturma sırasında durumu okur)Modifier.background(color = Color, shape = Shape)Modifier.border(width, color, shape)Modifier.shadow(elevation, shape)Modifier.clip(shape)Modifier.blur(radius)
- Statik konum değiştiriciler:
Modifier.offset(x = dp, y = dp)(doğrudan değer aşımı)Modifier.absoluteOffset(x = dp, y = dp)
- Dinamik Composable Değiştiriciler:
Modifier.composed { ... }(oluşturma sırasında fabrika gövdesini çalıştırır; performans açısından önerilmez. Bunun yerine özel değiştiriciler içinModifier.Nodekullanın)
2. aşama: Düzen aşaması
Düzen aşaması, ayrı geçersiz kılma kapsamlarına sahip iki farklı alt adıma ayrılır:
2A adımı: Ölçüm
Boyutu (width, height) ve kısıtlamaları belirler. Burada okunan durum, yeniden ölçümü ve yeniden yerleştirmeyi tetikler:
Modifier.layout { measurable, constraints -> ... }:layout(w, h)öncesindeki kod, ölçüm sırasında yürütülür.
2B adımı: Yerleşim ve düzen geri çağırmaları
(x, y) koordinat konumunu belirler. Yerleştirme blokları içinde okunan durum, yalnızca yeniden yerleştirmeyi tetikler (ölçüm ve oluşturma atlanır):
Modifier.offset { IntOffset(x, y) }(lambda aşırı yüklemesi)Modifier.absoluteOffset { IntOffset(x, y) }(lambda aşırı yüklemesi)Modifier.layout { ... layout(w, h) { placeable.place(x, y) } }:layout(w, h) { ... }bloğunun içindeki kod.
Düzen gözlemleme geri çağırmaları, düzenleme aşaması sırasında veya sonrasında da çalıştırılır (bu geri çağırmalarda, oluşturma sırasında okunan duruma yazmaktan kaçının. Aksi takdirde geriye doğru yazma işlemi gerçekleşir):
Modifier.onSizeChanged { intSize -> ... }: Düğümün boyutları değiştiyse düzen ölçümü tamamlandıktan sonra çağrılır.Modifier.onPlaced { layoutCoordinates -> ... }veModifier.onLayoutRectChanged { ... }: Yerleşimden sonra, global pencere düzeni geçişlerine abone olmadan yerel koordinatları veya sınırları bildirmek için çağrılır.Modifier.onGloballyPositioned { layoutCoordinates -> ... }: Herhangi bir düğüm hareket ettiğinde tüm pencere düzeni geçişi tamamlandıktan sonra çağrılır. Mümkün olduğuncaonGloballyPositionedkullanmaktan kaçının. Görüntü alanı izleme içinModifier.onVisibilityChanged, yerel sınırlar içinModifier.onPlacedveyaModifier.onLayoutRectChanged,Modifier.Nodeiçinde isteğe bağlı olarakrequireLayoutCoordinates()kullanmayı tercih edin.
3. aşama: Çizim aşaması
Bu değiştiriciler, tuval çizimi sırasında yürütülür. Bu blokların içinde okunan durum, hem oluşturma hem de düzen aşamalarını atlayarak yalnızca çizim aşamasını çalıştırır:
Modifier.graphicsLayer { ... }:- Lambda'da güncellenen özellikler:
alpha,translationX,translationY,scaleX,scaleY,rotationX,rotationY,rotationZ,shadowElevation,shape,clip,renderEffect,transformOrigin.
- Lambda'da güncellenen özellikler:
Modifier.drawBehind { ... }:- Birleştirilebilir içeriğin arkasına tuval komutları çizer.
Modifier.drawWithContent { ... }:drawContent()ile çizim sırasını kontrol eder.
Modifier.drawWithCache { ... }:- Dış blok,
Path,PaintveyaBrushnesnelerini önbelleğe almak için boyut veya düzen değişikliklerinde çalışır;onDrawBehindveyaonDrawWithContenther kare çiziminde çalışır.
- Dış blok,
Yeniden oluşturma döngüsünün dışında - gözlem değiştiriciler
Bazı değiştiriciler erişilebilirlik, kullanıcı girişi ve yaşam döngüsü gözlemlerini işlemek için üç kare aşamasının dışında çalışır.
Anlamsal yapı ve erişilebilirlik
Erişilebilirlik hizmetleri (TalkBack) ve test için anlamsal özellikleri işler:
Modifier.semantics { ... }Modifier.clearAndSetSemantics { ... }
Giriş, hareketler ve etkinlikler
Üç aşamalı kare oluşturma ardışık düzeninin dışında çalışır, OS hareket etkinliklerini ve kullanıcı etkileşimlerini alır:
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 -> ... }: Geri çağırma, yapılandırılmış gecikmeden sonra bir eş yordamda composable'ın görünürlüğü değiştiğinde çağrılır.
Hızlı referans: Değer ve Lambda aşaması
Bir lambda'da durum değerinin okunması, okuma işlemini daha sonraki bir aşamaya erteler. Bu durumda, ilgili durum değiştiğinde önceki aşamalar atlanır:
| Değiştirici / Kalıp | Doğrudan Değer (Bileşim) | Lambda Varyantı (Ertelenen Aşama) | Durum Değiştiğinde |
|---|---|---|---|
| Ofset | Modifier.offset(x, y) |
Modifier.offset { IntOffset(x, y) } |
Düzen (Yerleşim) (Oluşturmayı Atlar) |
| Alfa / Opaklık | Modifier.alpha(alpha) |
Modifier.graphicsLayer { this.alpha = alpha } |
Çizim (Oluşturma ve Düzen aşamalarını atlar) |
| Döndürme | Modifier.rotate(degrees) |
Modifier.graphicsLayer { rotationZ = degrees } |
Çizim (Oluşturma ve Düzen aşamalarını atlar) |
| Scale | Modifier.scale(scale) |
Modifier.graphicsLayer { scaleX = s; scaleY = s } |
Çizim (Oluşturma ve Düzen aşamalarını atlar) |
| Translation | Modifier.padding(...) |
Modifier.graphicsLayer { translationX = ... } |
Çizim (Oluşturma ve Düzen aşamalarını atlar) |
| Arka plan rengi | Modifier.background(color) |
Modifier.drawBehind { drawRect(color) } |
Çizim (Oluşturma ve Düzen aşamalarını atlar) |
| Kaydırma / Paralaks | Modifier.offset(scroll.dp) |
Modifier.offset { IntOffset(0, scroll) } |
Düzen (Yerleşim) (Oluşturmayı Atlar) |
Modifier.Node arayüzü eşleme
Yüksek performanslı Modifier.Node API'yi kullanan özel değiştiriciler için aşamalar doğrudan düğüm özelliği arayüzleriyle eşlenir:
| Aşama | Modifier.Node arayüzü |
Temel Yöntemler |
|---|---|---|
| Düzen (Ölçme ve Yerleştirme) | LayoutModifierNode |
measure(measurable, constraints) |
| Düzen (Genel Koordinatlar) | GlobalPositionAwareModifierNode (seç-izle için requireLayoutCoordinates() tercih edilir) |
onGloballyPositioned(coordinates) |
| Düzen (Yerleşim) | LayoutAwareModifierNode |
onRemeasured(size), onPlaced(coordinates) |
| Çizim | DrawModifierNode |
draw(ContentDrawScope) |
| Giriş / İşaretçi | PointerInputModifierNode |
onPointerEvent(...), onCancelPointerInput() |
| Semantik | SemanticsModifierNode |
applySemantics(SemanticsPropertyReceiver) |
| Odak | FocusEventModifierNode |
onFocusEvent(focusState) |