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:
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.
Ö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:
- Alt öğeleri ölçme: Düğüm, varsa alt öğelerini ölçer.
- Kendi boyutuna karar verme: Düğüm, bu ölçümlere göre kendi boyutuna karar verir.
- 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.
- 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.
- Tam: Düğümden tam bir boyut koşuluna uyması istenir. Minimum ve maksimum sınırlar aynı değere ayarlanır.
- 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.
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:
- 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.
- 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.
- 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.
- Ü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.
- Bir üst öğenin tüm alt öğeleri ölçüldükten sonra üst düğüm kendi boyutuna karar verir ve bunu kendi üst öğesine iletir.
- 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:
size değiştiricisi, gelen kısıtlamaları kendisine iletilen değerle eşleşecek şekilde uyarlar.
Bu örnekte değer 150dp:
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:
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:
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:
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:
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.
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:
Image, değiştirici zinciri sonucunda maksimum boyutu doldurur.fillMaxSizedeğiştiricisi, kısıtlamaları hem minimum genişliği hem de yüksekliği maksimum değere (300dpgenişlik ve200dpyükseklik) ayarlayacak şekilde değiştirir.sizedeğiştiricisi50dpboyutunu kullanmak istese de gelen minimum kısıtlamalara uyması gerekir. Bu nedenle,sizedeğiştirici de300x200olan tam kısıtlama sınırlarını verir vesizedeğiştiricide sağlanan değeri yok sayar.Imagebu sınırlara uyar ve300x200boyutunu 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:
Image ortalanır ve 50dp boyutuna getirilir.fillMaxSizedeğiştiricisi, kısıtlamaları hem minimum genişliği hem de yüksekliği maksimum değere (300dpgenişlik ve200dpyükseklik) ayarlayacak şekilde uyarlar.wrapContentSizedeğiştiricisi, minimum kısıtlamaları sıfırlar.fillMaxSize, sabit kısıtlamalarla sonuçlanırkenwrapContentSize, 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.sizedeğiştiricisi, kısıtlamaları50için minimum ve maksimum sınırlara ayarlar.Image,50x50boyutuna çözümlenir vesizedeğiştirici bunu iletir.wrapContentSizedeğ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:
clipdeğiştiricisi, kısıtlamaları değiştirmez.paddingdeğiştiricisi, maksimum kısıtlamaları azaltır.sizedeğiştiricisi, tüm kısıtlamaları100dpolarak ayarlar.Imagebu kısıtlamalara uyar ve100dpx100dpboyutunu bildirir.paddingdeğiştiricisi,Imagetarafından bildirilen boyuta her taraftan10dpekler. Bu nedenle, dolgulu düzen120dpgenişlik ve yükseklik bildirir.- Çizim aşamasında
clipdeğiştiricisi,120dpx120dpboyutundaki bir tuval üzerinde çalışır. Bu boyutlarda bir daire maskesi oluşturulur. paddingdeğiştiricisi, içeriğini her taraftan10dpkadar içe doğru kaydırır. Bu daImageiçin tuval boyutunu100dpx100dpdeğerine düşürür.Imagebu küçük tuvalde çizilir. Resim, orijinal120dpdairesine 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:
requiredWidth(400.dp) ile Box, 300dp kapsayıcısının her iki tarafına 50dp kadar uzanır.requiredWidthdeğiştiricisi, gelen genişlik kısıtlamalarını400dpdeğerinin tam sınırlarıyla değiştirir. Gelen yükseklik kısıtlamalarını (0-200dp) korur.heightdeğiştiricisi, yüksekliği100dpolarak ayarlar. Bu değer, yükseklik kısıtlamalarına uygundur.Box,400dpdeğerini100dpile ölçer. Bu genişlik, kapsayıcının izin verdiği300dpdeğerinden daha büyük olduğundanrequiredWidth, üst öğesine300dpgenişliğini bildirir ve içeriğini bu alanda ortalar:Box, kapsayıcının her iki tarafında50dpkadar 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:
widthIn ile Box, 300dp değerini 100dp cinsinden ölçer ve kapsayıcının içinde kalır.widthIndeğiştiricisi,100dpile400dparasında bir genişlik ister. Gelen maksimum genişlik300dpolduğundan genişlik kısıtlamaları100dpile300dparasında olur.heightIndeğiştiricisi, maksimum yüksekliği100dpolarak ayarlar. Bu nedenle, yükseklik kısıtlamaları0ile100dparasında olur.fillMaxSizedeğiştiricisi, minimum genişlik ve yüksekliği bu maksimum değerlere ayarlar. BöyleceBox,300dpx100dpboyutunda 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:
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.requiredSizeIndeğiştiricisi, gelen kısıtlamaları100dpile400dparasında bir genişlik ve0ile100dparasında bir yükseklik ile değiştirir. Minimum yükseklik ayarlanmadığından gelen minimum yükseklik olan0korunur.fillMaxSizedeğiştiricisi, minimum genişlik ve yüksekliği bu maksimum değerlere ayarlar. Bu nedenle,Box400dpx100dpboyutundadır.requiredWidthörneğinde olduğu gibi, genişlik kapsayıcının izin verdiğinden daha büyük olduğundanBoxortalanır ve her iki taraftan50dptaşar.
Aynı aralıkta widthIn ve heightIn, Box değerini kapsayıcının içinde tutarken requiredSizeIn tutmaz.