Aşamaya göre değiştirici dökümü

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) ( RowScope veya ColumnScope cinsinden)
    • 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çin Modifier.Node kullanı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 -> ... } ve Modifier.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ğunca onGloballyPositioned kullanmaktan kaçının. Görüntü alanı izleme için Modifier.onVisibilityChanged, yerel sınırlar için Modifier.onPlaced veya Modifier.onLayoutRectChanged, Modifier.Node içinde isteğe bağlı olarak requireLayoutCoordinates() 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.
  • 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, Paint veya Brush nesnelerini önbelleğe almak için boyut veya düzen değişikliklerinde çalışır; onDrawBehind veya onDrawWithContent her kare çiziminde çalışır.

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 / awaitPointerEventScope
  • Modifier.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)