Sınırlamalar ve değiştirici sırası

Compose'da, bir composable'ın görünümünü ve tarzını değiştirmek için birden fazla değiştiriciyi birbirine bağlayabilirsiniz. Bu değiştirici zincirleri, composable'lara iletilen ve genişlik ile yükseklik sınırlarını tanımlayan kısıtlamaları etkileyebilir.

Bu sayfada, zincirleme değiştiricilerin kısıtlamaları ve dolayısıyla composable'ların ölçümünü ve yerleşimini nasıl etkilediği açıklanmaktadır.

Kullanıcı arayüzü ağacındaki değiştiriciler

Değiştiricilerin birbirini nasıl etkilediğini anlamak için oluşturma aşamasında oluşturulan kullanıcı arayüzü ağacında nasıl göründüklerini görselleştirmek faydalı olur. Daha fazla bilgi için Oluşturma bölümüne bakın.

Kullanıcı arayüzü ağacında, değiştiricileri düzen düğümleri için sarmalayıcı düğümler olarak görselleştirebilirsiniz:

Oluşturulabilir öğeler ve değiştiriciler için kod ve bunların kullanıcı arayüzü ağacı olarak görsel temsili.
Şekil 1. Kullanıcı arayüzü ağacındaki düzen düğümlerini sarmalayan değiştiriciler.

Bir composable'a birden fazla değiştirici eklediğinizde değiştirici zinciri oluşturulur. Birden fazla değiştiriciyi zincirlediğinizde her değiştirici düğümü, zincirin geri kalanını ve içindeki düzen düğümünü sarmalar. Örneğin, bir clip ve bir size değiştiriciyi zincirlediğinizde clip değiştirici düğümü, size değiştirici düğümünü sarmalar. Bu düğüm de Image düzen düğümünü sarmalar.

Düzen aşamasında, ağaçta gezinen algoritma aynı kalır ancak her değiştirici düğüm de ziyaret edilir. Bu sayede, bir değiştirici, sarmaladığı değiştiricinin veya düzen düğümünün boyut gereksinimlerini ve yerleşimini değiştirebilir.

Şekil 2'de gösterildiği gibi, Image ve Text composable'larının uygulanması, tek bir düzen düğümünü sarmalayan bir değiştirici zincirinden oluşur.

Row ve Column uygulamaları, alt öğelerinin nasıl düzenleneceğini açıklayan düzen düğümleridir.

Önceki ağaç yapısı, ancak artık her düğüm, etrafında çok sayıda değiştirici sarmalama düğümü bulunan basit bir düzenden ibaret.
Şekil 2. Şekil 1'deki ağaç yapısının aynısı ancak kullanıcı arayüzü ağacındaki composable'lar değiştirici zincirleri olarak görselleştirilmiştir.

Özetlemek gerekirse:

  • Değiştiriciler, tek bir değiştiriciyi veya düzen düğümünü sarmalar.
  • Düzen düğümleri, birden fazla alt düğümü düzenleyebilir.

Aşağıdaki bölümlerde, değiştirici zincirleme ve bunun composable'ların boyutunu nasıl etkilediği hakkında akıl yürütmek için bu zihinsel modelin nasıl kullanılacağı açıklanmaktadır.

Düzen aşamasındaki kısıtlamalar

Düzen aşaması, her düzen düğümünün genişliğini, yüksekliğini ve x, y koordinatını bulmak için üç adımlı bir algoritma kullanır:

  1. Alt öğeleri ölçme: Düğüm, varsa alt öğelerini ölçer.
  2. Kendi boyutuna karar verme: Düğüm, bu ölçümlere göre kendi boyutuna karar verir.
  3. Alt öğeleri yerleştirme: Her alt düğüm, bir düğümün kendi konumuna göre yerleştirilir.

Constraints, algoritmanın ilk iki adımında düğümler için doğru boyutların bulunmasına yardımcı olur. Kısıtlamalar, bir düğümün genişliği ve yüksekliği için minimum ve maksimum sınırları tanımlar. Düğüm, boyutuna karar verdiğinde ölçülen boyutu bu boyut aralığında olmalıdır.

Kısıtlama türleri

Kısıtlama aşağıdakilerden biri olabilir:

  • Sınırlı: Düğümün maksimum ve minimum genişliği ve yüksekliği vardır.
Bir kapsayıcı içinde farklı boyutlarda sınırlı kısıtlamalar.
Şekil 3. Sınırlı kısıtlamalar.
  • Sınırsız: Düğüm herhangi bir boyutla sınırlı değildir. Maksimum genişlik ve yükseklik sınırları sonsuz olarak ayarlanır.
Genişlik ve yüksekliğin sonsuz olarak ayarlandığı sınırsız kısıtlamalar. Kısıtlamalar kapsayıcının ötesine uzanıyor.
Şekil 4. Sınırsız kısıtlamalar.
  • Tam: Düğümden tam bir boyut koşuluna uyması istenir. Minimum ve maksimum sınırlar aynı değere ayarlanır.
Kapsayıcı içindeki tam boyut koşuluna uyan tam kısıtlamalar.
Şekil 5. Tam kısıtlamalar.
  • Kombinasyon: Düğüm, önceki kısıtlama türlerinin bir kombinasyonunu izler. Örneğin, bir kısıtlama genişliği sınırlayabilir ancak sınırsız bir maksimum yüksekliğe izin verebilir veya tam bir genişlik ayarlayabilir ancak sınırlı bir yükseklik sağlayabilir.
Sınırlı ve sınırsız kısıtlamaların yanı sıra tam genişlik ve yükseklik kombinasyonlarını gösteren iki kapsayıcı.
Şekil 6. Sınırlı ve sınırsız kısıtlamalar ile tam genişlik ve yüksekliklerin kombinasyonları.

Sonraki bölümde, bu kısıtlamaların üst öğeden alt öğeye nasıl aktarıldığı açıklanmaktadır.

Kısıtlamalar üst öğeden alt öğeye nasıl aktarılır?

Düzen aşamasındaki kısıtlamalar bölümünde açıklanan algoritmanın ilk adımında, kısıtlamalar kullanıcı arayüzü ağacındaki üst öğeden alt öğeye aktarılır.

Bir üst düğüm, alt öğelerini ölçerken her bir alt öğeye bu kısıtlamaları sağlar. Böylece alt öğeler, ne kadar büyük veya küçük olmalarına izin verildiğini bilir. Ardından, kendi boyutuna karar verirken kendi üst öğeleri tarafından iletilen kısıtlamalara da uyar.

Algoritma genel olarak şu şekilde çalışır:

  1. Kullanıcı arayüzü ağacındaki kök düğüm, kaplamak istediği boyuta karar vermek için alt öğelerini ölçer ve aynı kısıtlamaları ilk alt öğesine iletir.
  2. Alt öğe, ölçümü etkilemeyen bir değiştiriciyse kısıtlamaları bir sonraki değiştiriciye iletir. Kısıtlamalar, ölçümü etkileyen bir değiştiriciye ulaşılmadığı sürece değiştirici zincirine olduğu gibi iletilir. Kısıtlamalar buna göre yeniden boyutlandırılır.
  3. Alt öğesi olmayan bir düğüme ("yaprak düğüm" olarak adlandırılır) ulaşıldığında, iletilen kısıtlamalara göre boyutuna karar verir ve bu çözümlenmiş boyutu üst öğesine döndürür.
  4. Üst öğe, kısıtlamalarını bu alt öğenin ölçümlerine göre uyarlar ve bir sonraki alt öğesini bu ayarlanmış kısıtlamalarla çağırır.
  5. Bir üst öğenin tüm alt öğeleri ölçüldükten sonra üst düğüm kendi boyutuna karar verir ve bunu kendi üst öğesine iletir.
  6. Bu şekilde, tüm ağaç derinlik öncelikli olarak taranır. Sonunda tüm düğümler boyutlarına karar verir ve ölçüm adımı tamamlanır.

Ayrıntılı bir örnek için Kısıtlamalar ve değiştirici sırası videosunu izleyin.

Kısıtlamaları etkileyen değiştiriciler

Önceki bölümde, bazı değiştiricilerin kısıtlama boyutunu etkileyebileceğini öğrendiniz. Aşağıdaki bölümlerde, kısıtlamaları etkileyen belirli değiştiriciler açıklanmaktadır.

size değiştiricisi

size değiştiricisi, içeriğin tercih edilen boyutunu bildirir.

Örneğin, aşağıdaki kullanıcı arayüzü ağacı 300dp x 200dp boyutunda bir kapsayıcıda oluşturulmalıdır. Sınırlamalar, 100dp ile 300dp arasında genişliklere ve 100dp ile 200dp arasında yüksekliklere izin verir:

Bir düzen düğümünü sarmalayan boyut değiştiriciye sahip bir kullanıcı arayüzü ağacının bir kısmı ve bir kapsayıcıda boyut değiştirici tarafından ayarlanan sınırlı kısıtlamaların temsili.
Şekil 7. Kullanıcı arayüzü ağacındaki sınırlı kısıtlamalar ve bunların bir kapsayıcıdaki temsili.

size değiştiricisi, gelen kısıtlamaları kendisine iletilen değerle eşleşecek şekilde uyarlar. Bu örnekte değer 150dp:

Şekil 7 ile aynıdır ancak boyut değiştirici, gelen kısıtlamaları kendisine iletilen değere uyacak şekilde uyarlar.
Şekil 8. size değiştiricisi, kısıtlamaları 150dp olarak ayarlıyor.

Genişlik ve yükseklik, en küçük kısıtlama sınırından küçük veya en büyük kısıtlama sınırından büyükse değiştirici, iletilen kısıtlamalara uymaya devam ederken iletilen kısıtlamalarla mümkün olduğunca eşleşir:

İki kullanıcı arayüzü ağacı ve bunların kapsayıcılardaki karşılık gelen temsilleri. İlkinde, boyut değiştirici gelen kısıtlamaları kabul eder. İkincisinde ise boyut değiştirici, çok büyük kısıtlamalara mümkün olduğunca uyum sağlayarak kapsayıcıyı dolduran kısıtlamalar oluşturur.
Şekil 9. Geçirilen kısıtlamaya mümkün olduğunca uyan size değiştirici.

Birden fazla size değiştiriciyi zincirlemenin işe yaramayacağını unutmayın. İlk size değiştirici, hem minimum hem de maksimum kısıtlamaları sabit bir değere ayarlar. İkinci boyut değiştirici daha küçük veya daha büyük bir boyut istese bile iletilen tam sınırlara uyması gerektiğinden bu değerleri geçersiz kılmaz:

Kullanıcı arayüzü ağacındaki iki boyut değiştirici zinciri ve bunun bir kapsayıcıdaki temsili.
  Bu, ikinci değerin değil, iletilen ilk değerin sonucudur.
Şekil 10. İkinci değerin (50dp) ilk değeri (100dp) geçersiz kılmadığı iki size değiştiriciden oluşan bir zincir.

requiredSize değiştiricisi

Düğümünüzün gelen kısıtlamaları geçersiz kılması gerekiyorsa size yerine requiredSize değiştiricisini kullanın. requiredSize değiştiricisi, gelen kısıtlamaları değiştirir ve belirttiğiniz boyutu tam sınırlar olarak iletir.

Geçirdiğiniz boyut, gelen kısıtlamaların dışındaysa düğüm, boyut ağaçta yukarı doğru geçirildiğinde bunlara uyan bir boyut bildirir ve içeriği, iki boyutun farklı olduğu her eksende bu alanda ortalanır. Sınırlamalardan daha büyük içerikler, sınırlamaların dışına taşar. Şekil 11'de requiredSize(50), size tarafından iletilen 100dp değerinden daha küçüktür. Bu nedenle 50dp içeriği, 100dp alanında ortalanır:

Kullanıcı arayüzü ağacında zincirlenmiş size ve requiredSize değiştiricisi ve bir kapsayıcıdaki karşılık gelen gösterimi. requiredSize değiştirici kısıtlamaları, boyut değiştirici kısıtlamalarını geçersiz kılar.
Şekil 11. requiredSize değiştiricisi, size değiştiricisinden gelen kısıtlamaları geçersiz kılıyor.

width ve height değiştiricileri

size değiştiricisi, kısıtlamaların hem genişliğini hem de yüksekliğini uyarlar. width değiştiricisiyle sabit bir genişlik ayarlayabilir ancak yüksekliği belirlemeden bırakabilirsiniz. Benzer şekilde, height değiştiricisiyle sabit bir yükseklik ayarlayabilir ancak genişliği belirlemeden bırakabilirsiniz:

İki kullanıcı arayüzü ağacı: Biri genişlik değiştirici ve kapsayıcı temsili, diğeri ise yükseklik değiştirici ve temsili.
Şekil 12. width değiştiricisi ve height değiştiricisi, sırasıyla sabit bir genişlik ve yükseklik ayarlar.

Gelen kısıtlamaları geçersiz kılan bir genişlik veya yükseklik ayarlamak için requiredWidth ya da requiredHeight kullanın. requiredSize gibi her biri gelen kısıtlamaları değiştirir ancak yalnızca kendi ekseninde: requiredWidth gelen yükseklik kısıtlamalarını, requiredHeight ise gelen genişlik kısıtlamalarını korur.

sizeIn değiştiricisi

sizeIn değiştiricisi, gelen kısıtlamalar dahilinde genişlik ve yükseklik için minimum ve maksimum kısıtlamalar belirlemenize olanak tanır. Gelen kısıtlamalar daha sıkı olduğunda öncelik kazanır. Kısıtlamalar üzerinde ayrıntılı kontrol gerekiyorsa sizeIn değiştiricisini kullanın. widthIn ve heightIn değiştiricileri, bir eksende aynı işlemi yapar ve diğer eksenin kısıtlamalarını değiştirmez. Her biri minimum, maksimum veya her ikisini birden alır.

Minimum ve maksimum genişlik ve yükseklik değerleri ayarlanmış sizeIn değiştiricisine sahip bir kullanıcı arayüzü ağacı ve bunun bir kapsayıcı içindeki temsili.
Şekil 13. minWidth, maxWidth, minHeight ve maxHeight ayarlanmış sizeIn değiştirici.

Gelen kısıtlamaları geçersiz kılan bir aralık ayarlamak için bir eksende requiredSizeIn veya requiredWidthIn ve requiredHeightIn kullanın. sizeIn, widthIn ve heightIn ile requiredSize ve size arasındaki ilişki aynıdır.

Örnekler

Bu bölümde, zincirleme değiştiriciler içeren çeşitli kod snippet'lerinin çıkışı gösterilir ve açıklanır.

Image(
    painterResource(R.drawable.hero),
    contentDescription = null,
    Modifier
        .fillMaxSize()
        .size(50.dp)
)

Bu snippet aşağıdaki çıkışı üretir:

Üst kapsayıcısını dolduran mavi bir kare.
Şekil 14. Image, değiştirici zinciri sonucunda maksimum boyutu doldurur.
  • fillMaxSize değiştiricisi, kısıtlamaları hem minimum genişliği hem de yüksekliği maksimum değere (300dp genişlik ve 200dp yükseklik) ayarlayacak şekilde değiştirir.
  • size değiştiricisi 50dp boyutunu kullanmak istese de gelen minimum kısıtlamalara uyması gerekir. Bu nedenle, size değiştirici de 300 x 200 olan tam kısıtlama sınırlarını verir ve size değiştiricide sağlanan değeri yok sayar.
  • Image bu sınırlara uyar ve 300 x 200 boyutunu bildirir. Bu boyut, ağacın en üstüne kadar iletilir.

Image(
    painterResource(R.drawable.hero),
    contentDescription = null,
    Modifier
        .fillMaxSize()
        .wrapContentSize()
        .size(50.dp)
)

Bu snippet aşağıdaki çıkışı üretir:

Üst kapsayıcısının ortasında küçük mavi bir kare.
Şekil 15. Image ortalanır ve 50dp boyutuna getirilir.
  • fillMaxSize değiştiricisi, kısıtlamaları hem minimum genişliği hem de yüksekliği maksimum değere (300dp genişlik ve 200dp yükseklik) ayarlayacak şekilde uyarlar.
  • wrapContentSize değiştiricisi, minimum kısıtlamaları sıfırlar. fillMaxSize, sabit kısıtlamalarla sonuçlanırken wrapContentSize, sınırlı kısıtlamalara geri döndürür. Sonraki düğüm artık tüm alanı kaplayabilir veya tüm alandan daha küçük olabilir.
  • size değiştiricisi, kısıtlamaları 50 için minimum ve maksimum sınırlara ayarlar.
  • Image, 50 x 50 boyutuna çözümlenir ve size değiştirici bunu iletir.
  • wrapContentSize değiştiricisinin özel bir özelliği vardır. Alt öğesini alır ve kendisine iletilen minimum sınırların ortasına yerleştirir. Bu nedenle, üst öğelerine ilettiği boyut, kendisine iletilen minimum sınırlara eşittir.

Yalnızca üç değiştiriciyi birleştirerek composable için bir boyut tanımlayabilir ve üst öğesinde ortalayabilirsiniz.

Image(
    painterResource(R.drawable.hero),
    contentDescription = null,
    Modifier
        .clip(CircleShape)
        .padding(10.dp)
        .size(100.dp)
)

Bu snippet aşağıdaki çıkışı üretir:

Değiştirici sırası nedeniyle yanlış kırpılan dairesel bir şekil.
Şekil 16. Değiştirici sırası nedeniyle yanlış kırpılmış bir şekil.
  • clip değiştiricisi, kısıtlamaları değiştirmez.
  • padding değiştiricisi, maksimum kısıtlamaları azaltır.
  • size değiştiricisi, tüm kısıtlamaları 100dp olarak ayarlar.
  • Image bu kısıtlamalara uyar ve 100dp x 100dp boyutunu bildirir.
  • padding değiştiricisi, Image tarafından bildirilen boyuta her taraftan 10dp ekler. Bu nedenle, dolgulu düzen 120dp genişlik ve yükseklik bildirir.
  • Çizim aşamasında clip değiştiricisi, 120dp x 120dp boyutundaki bir tuval üzerinde çalışır. Bu boyutlarda bir daire maskesi oluşturulur.
  • padding değiştiricisi, içeriğini her taraftan 10dp kadar içe doğru kaydırır. Bu da Image için tuval boyutunu 100dp x 100dp değerine düşürür.
  • Image bu küçük tuvalde çizilir. Resim, orijinal 120dp dairesine göre kırpıldığından sonuç dairesel olmaz.

Sonraki üç snippet, arka plan rengi olan bir Box öğesini aynı 300dp x 200dp kapsayıcısına yerleştirir.

Box(
    modifier = Modifier
        .requiredWidth(400.dp)
        .height(100.dp)
        .background(Color(0xFF3DDC84))
)

Bu snippet aşağıdaki çıkışı üretir:

Açık mavi bir kapsayıcının ortasında, kapsayıcının her iki tarafına yatay olarak uzanan geniş, yeşil bir dikdörtgen.
Şekil 17. requiredWidth(400.dp) ile Box, 300dp kapsayıcısının her iki tarafına 50dp kadar uzanır.
  • requiredWidth değiştiricisi, gelen genişlik kısıtlamalarını 400dp değerinin tam sınırlarıyla değiştirir. Gelen yükseklik kısıtlamalarını (0 - 200dp) korur.
  • height değiştiricisi, yüksekliği 100dp olarak ayarlar. Bu değer, yükseklik kısıtlamalarına uygundur.
  • Box, 400dp değerini 100dp ile ölçer. Bu genişlik, kapsayıcının izin verdiği 300dp değerinden daha büyük olduğundan requiredWidth, üst öğesine 300dp genişliğini bildirir ve içeriğini bu alanda ortalar: Box, kapsayıcının her iki tarafında 50dp kadar taşar.

Box(
    modifier = Modifier
        .widthIn(min = 100.dp, max = 400.dp)
        .heightIn(max = 100.dp)
        .fillMaxSize()
        .background(Color(0xFF3DDC84))
)

Bu snippet aşağıdaki çıkışı üretir:

Açık mavi bir kapsayıcının içinde dikey olarak ortalanmış yeşil bir dikdörtgen.
    Dikdörtgen, kapsayıcının tam genişliğine uyuyor ve yanlarından taşmıyor.
Şekil 18. widthIn ile Box, 300dp değerini 100dp cinsinden ölçer ve kapsayıcının içinde kalır.
  • widthIn değiştiricisi, 100dp ile 400dp arasında bir genişlik ister. Gelen maksimum genişlik 300dp olduğundan genişlik kısıtlamaları 100dp ile 300dp arasında olur.
  • heightIn değiştiricisi, maksimum yüksekliği 100dp olarak ayarlar. Bu nedenle, yükseklik kısıtlamaları 0 ile 100dp arasında olur.
  • fillMaxSize değiştiricisi, minimum genişlik ve yüksekliği bu maksimum değerlere ayarlar. Böylece Box, 300dp x 100dp boyutunda olur ve kapsayıcının içinde kalır.

Box(
    modifier = Modifier
        .requiredSizeIn(minWidth = 100.dp, maxWidth = 400.dp, maxHeight = 100.dp)
        .fillMaxSize()
        .background(Color(0xFF3DDC84))
)

Bu snippet aşağıdaki çıkışı üretir:

Açık mavi bir kapsayıcının ortasında, kapsayıcının her iki tarafına yatay olarak uzanan geniş, yeşil bir dikdörtgen.
Şekil 19. requiredSizeIn ile Box, 400dp x 100dp boyutunda olur ve kapsayıcının her iki tarafına 50dp taşar. Bu, Şekil 17 ile aynı sonucu verir.
  • requiredSizeIn değiştiricisi, gelen kısıtlamaları 100dp ile 400dp arasında bir genişlik ve 0 ile 100dp arasında bir yükseklik ile değiştirir. Minimum yükseklik ayarlanmadığından gelen minimum yükseklik olan 0 korunur.
  • fillMaxSize değiştiricisi, minimum genişlik ve yüksekliği bu maksimum değerlere ayarlar. Bu nedenle, Box 400dp x 100dp boyutundadır.
  • requiredWidth örneğinde olduğu gibi, genişlik kapsayıcının izin verdiğinden daha büyük olduğundan Box ortalanır ve her iki taraftan 50dp taşar.

Aynı aralıkta widthIn ve heightIn, Box değerini kapsayıcının içinde tutarken requiredSizeIn tutmaz.