Standart düzenler

Standart düzenler, çeşitli form faktörlerinde optimum kullanıcı deneyimi sağlayan, kanıtlanmış ve çok yönlü düzenlerdir.

Standart düzenler, küçük ekranlı telefonların yanı sıra tabletleri, katlanabilir cihazları ve ChromeOS cihazları destekler. Materyal Tasarım rehberliğinden türetilen düzenler hem estetik hem de işlevseldir.

Android çerçevesi, düzenlerin uygulanmasını kolay ve güvenilir hale getiren özel bileşenler içerir.

Kanonik düzenler, harika uygulamaların temelini oluşturan, ilgi çekici ve üretkenliği artıran kullanıcı arayüzleri oluşturur.

Liste-ayrıntı

Liste-ayrıntı düzeni, kullanıcıların açıklayıcı, açıklayıcı veya diğer ek bilgileri (öğe ayrıntısı) içeren öğe listelerini keşfetmesini sağlar.

Düzen, uygulama penceresini yan yana iki bölmeye ayırır: biri liste, diğeri ayrıntı için. Kullanıcılar, öğe ayrıntılarını görüntülemek için listeden öğe seçer. Ayrıntı bölümündeki derin bağlantılar, ayrıntı bölmesinde ek içerik gösterir.

Genişletilmiş genişlikteki ekranlar (bkz. Pencere boyutu sınıflarını kullanma) hem listeyi hem de ayrıntıları aynı anda gösterir. Bir liste öğesinin seçilmesiyle ayrıntılar bölmesi, seçilen öğeyle ilgili içeriği gösterecek şekilde güncellenir.

Orta ve küçük genişlikteki ekranlarda, uygulamayla kullanıcı etkileşimine bağlı olarak liste veya ayrıntı gösterilir. Yalnızca liste görünür olduğunda, bir liste öğesinin seçilmesiyle liste yerine ayrıntı gösterilir. Yalnızca ayrıntı görünürken geri düğmesine basıldığında liste yeniden gösterilir.

Cihaz yönü değişiklikleri veya uygulama penceresi boyutu değişiklikleri gibi yapılandırma değişiklikleri, ekranın pencere boyutu sınıfını değiştirebilir. Liste-ayrıntı düzeni, uygulama durumunu koruyarak buna göre yanıt verir:

• Hem liste hem de ayrıntılar bölmelerini gösteren genişletilmiş bir ekran, orta veya kompakt genişliğe daralırsa ayrıntılar bölmesi görünür kalır ve liste bölmesi gizlenir.
• Orta veya kompakt genişlikteki bir ekranda yalnızca ayrıntı bölmesi görünür durumdayken pencere boyutu sınıfı genişletilmiş olarak genişlerse liste ve ayrıntı birlikte gösterilir ve listede, ayrıntı bölmesindeki içeriğe karşılık gelen öğenin seçildiği belirtilir.
• Orta veya kompakt genişlikteki bir ekranda yalnızca liste bölmesi görünür durumdayken genişletilmiş görünümde liste ve yer tutucu ayrıntı bölmesi birlikte gösterilir.

Liste-ayrıntı, mesajlaşma uygulamaları, kişi yöneticileri, etkileşimli medya tarayıcıları veya içeriğin ek bilgiler gösteren öğe listesi olarak düzenlenebileceği tüm uygulamalar için idealdir.

Uygulama

Compose'un bildirimsel paradigması, liste ve ayrıntı panellerinin aynı anda (genişlik pencere boyutu sınıfı genişletildiğinde) veya yalnızca liste ya da ayrıntı panelinin (genişlik pencere boyutu sınıfı orta veya kompakt olduğunda) gösterilip gösterilmeyeceğini belirleyen pencere boyutu sınıfı mantığını destekler.

Tek yönlü veri akışını sağlamak için mevcut pencere boyutu sınıfı ve seçilen liste öğesinin ayrıntıları (varsa) dahil olmak üzere tüm durumu yükseltin. Böylece tüm composable'lar verilere erişebilir ve doğru şekilde oluşturabilir.

Küçük pencere boyutlarında yalnızca ayrıntı bölmesi gösterilirken ayrıntı bölmesini kaldırıp yalnızca liste bölmesini görüntülemek için BackHandler simgesini ekleyin. İşleyici, pencere boyutu sınıfına ve seçilen ayrıntı durumuna bağlı olduğundan BackHandler, genel uygulama gezinmesinin bir parçası değildir.

ListDetailPaneScaffold, liste-ayrıntı düzenlerinin uygulanmasını kolaylaştıran üst düzey bir composable'dır. Pencere boyutu sınıflarına göre bölme mantığını otomatik olarak işler ve bölmeler arasında gezinmeyi destekler.

ListDetailPaneScaffold kullanan minimum bir uygulamayı aşağıda bulabilirsiniz:

@OptIn(ExperimentalMaterial3AdaptiveApi::class)
@Composable
fun MyListDetailPaneScaffold() {
    val navigator = rememberListDetailPaneScaffoldNavigator()
    ListDetailPaneScaffold(
        directive = navigator.scaffoldDirective,
        value = navigator.scaffoldValue,
        listPane = {
            // Listing Pane
        },
        detailPane = {
            // Details Pane
        }
    )
}
CanonicalLayoutSamples.kt

Bu örnekteki temel bileşenler şunlardır:

• rememberListDetailPaneScaffoldNavigator: Liste ve ayrıntı bölmeleri arasında gezinmeyi yönetmek için bir gezgin oluşturur.
• listPane: Öğe listesini gösterir.
• detailPane: Seçilen öğenin içeriğini gösterir.

Ayrıntılı uygulama örnekleri için:

• Liste-ayrıntı düzeni oluşturma geliştirici kılavuzu
• list-detail-compose liste-ayrıntı düzeni örneği

Feed

Feed düzeni, eşdeğer içerik öğelerini yapılandırılabilir bir ızgarada düzenleyerek çok miktarda içeriğin hızlı ve kolay bir şekilde görüntülenmesini sağlar.

Boyut ve konum, içerik öğeleri arasında ilişkiler oluşturur.

İçerik grupları, öğelerin aynı boyutta olması ve birlikte konumlandırılmasıyla oluşturulur. Öğeler, yakındaki öğelerden daha büyük yapılarak dikkat çekilir.

Kartlar ve listeler, feed düzenlerinin yaygın bileşenleridir.

Feed düzeni, ızgara tek bir kaydırılabilir sütundan çok sütunlu kaydırılabilir bir içerik feed'ine uyarlanabildiği için neredeyse her boyuttaki ekranı destekler.

Feed'ler özellikle haber ve sosyal medya uygulamaları için uygundur.

Uygulama

Feed, dikey kaydırma içeren bir kapsayıcıda ızgara şeklinde düzenlenmiş çok sayıda içerik öğesinden oluşur. Lazy listeler, sütun veya satırlardaki çok sayıda öğeyi verimli bir şekilde oluşturur. Lazy grids, öğe boyutlarının ve aralıklarının yapılandırılmasını destekleyerek öğeleri ızgaralarda oluşturur.

Kılavuz öğeleri için izin verilen minimum genişliği ayarlamak üzere, kılavuz düzeninin sütunlarını kullanılabilir görüntüleme alanına göre yapılandırın. Izgara öğelerini tanımlarken bazı öğeleri diğerlerinden daha fazla vurgulamak için sütun aralıklarını ayarlayın.

Bölüm başlıkları, ayırıcılar veya feed'in tam genişliğini kaplayacak şekilde tasarlanmış diğer öğeler için düzenin tam genişliğini kaplamak üzere maxLineSpan kullanın.

Birden fazla sütun göstermek için yeterli alan olmayan dar ekranlarda LazyVerticalGrid, LazyColumn gibi davranır.

LazyVerticalGrid kullanan minimum bir uygulamayı aşağıda bulabilirsiniz:

@Composable
fun MyFeed(names: List<String>) {
    LazyVerticalGrid(
        // GridCells.Adaptive automatically adapts column count based on available width
        columns = GridCells.Adaptive(minSize = 180.dp),
    ) {
        items(names) { name ->
            Text(name)
        }
    }
}
CanonicalLayoutSamples.kt

Uyarlanabilir bir feed'in anahtarı columns yapılandırmasıdır. GridCells.Adaptive(minSize = 180.dp), her sütunun en az 180.dp genişliğinde olduğu bir ızgara oluşturur. Izgara, kullanılabilir alana sığabilecek sayıda sütun gösterir.

Örnek uygulama için Feed with Compose örneğine bakın.

Destek bölmesi

Destekleyici bölme düzeni, uygulama içeriğini birincil ve ikincil ekran alanları şeklinde düzenler.

Birincil görüntüleme alanı, uygulama penceresinin büyük bir bölümünü (genellikle yaklaşık üçte ikisini) kaplar ve ana içeriği barındırır. İkincil görüntüleme alanı, uygulama penceresinin geri kalanını kaplayan ve ana içeriği destekleyen içerikleri sunan bir bölmedir.

Desteklenen bölme düzenleri, yatay yönde genişletilmiş genişlikteki ekranlarda iyi çalışır (bkz. Pencere boyutu sınıflarını kullanma). Orta veya kompakt genişlikteki ekranlar, içerik daha dar ekran alanlarına uyarlanabiliyorsa ya da ek içerik, menü veya düğme gibi bir kontrol aracılığıyla erişilebilen alt veya yan sayfada başlangıçta gizlenebiliyorsa hem birincil hem de ikincil ekran alanlarının gösterilmesini destekler.

Destek bölmesi düzeni, birincil ve ikincil içerik ilişkisi açısından liste-ayrıntı düzeninden farklıdır. İkincil bölme içeriği yalnızca birincil içerikle ilişkili olarak anlamlıdır. Örneğin, destekleyici bölme araç penceresi tek başına alakasızdır. Ancak liste-ayrıntı düzeninin ayrıntı bölmesindeki ek içerik, birincil içerik olmadan da anlamlıdır. Örneğin, ürün listelemesindeki bir ürünün açıklaması.

Destek bölmesinin kullanım alanları şunlardır:

• Üretkenlik uygulamaları: Destekleyici bir bölmede inceleyen yorumlarının yer aldığı bir doküman veya e-tablo
• Medya uygulamaları: Destekleyici bir bölmede alakalı videoların listesiyle desteklenen bir akışlı video veya bir oynatma listesiyle desteklenen bir müzik albümünün tasviri
• Araçlar ve ayarlar: Destek bölmesinde paletler, efektler ve diğer ayarların bulunduğu bir medya düzenleme aracı

Uygulama

Compose, pencere boyutu sınıfı mantığını destekler. Bu sayede, hem ana içeriği hem de destekleyici içeriği aynı anda göstermeyi veya destekleyici içeriği alternatif bir konuma yerleştirmeyi seçebilirsiniz.

Mevcut pencere boyutu sınıfı ve ana içerik ile destekleyici içerikteki verilerle ilgili bilgiler de dahil olmak üzere tüm durumu yükseltin.

Dar ekranlarda destekleyici içeriği ana içeriğin altına veya bir alt sayfanın içine yerleştirin. Orta ve geniş genişliklerde, destekleyici içeriği ana içeriğin yanına yerleştirin. İçeriğin ve kullanılabilir alanın boyutuna göre uygun şekilde boyutlandırın. Orta genişlikte, ekran alanını ana içerik ve destekleyici içerik arasında eşit olarak bölün. Genişletilmiş genişlik için alanın% 70'ini ana içeriğe, %30'unu destekleyici içeriğe ayırın.

SupportingPaneScaffold, destekleyici bölme düzenlerinin uygulanmasını kolaylaştıran üst düzey bir composable'dır. Composable, pencere boyutu sınıflarına göre bölme mantığını otomatik olarak işler. Büyük ekranlarda bölmeleri yan yana gösterir veya küçük ekranlarda destekleyici bölmeyi gizler. SupportingPaneScaffold, paneler arasında gezinmeyi de destekler.

Aşağıda minimum düzeyde bir uygulama verilmiştir:

@OptIn(ExperimentalMaterial3AdaptiveApi::class)
@Composable
fun MySupportingPaneScaffold() {
    // Creates and remembers a navigator to control pane visibility and navigation
    val navigator = rememberSupportingPaneScaffoldNavigator()
    SupportingPaneScaffold(
        // Directive and value help control pane visibility based on screen size and state
        directive = navigator.scaffoldDirective,
        value = navigator.scaffoldValue,
        mainPane = {
            // Main Pane for the primary content
        },
        supportingPane = {
            //Supporting Pane for supplementary content
        }
    )
}
CanonicalLayoutSamples.kt

• rememberSupportingPaneScaffoldNavigator: Bölme görünürlüğünü yönetmek için bir gezinme aracı oluşturan composable (ör. kompakt ekranlarda destekleyici bölmeyi gizleme veya gösterme)
• mainPane: Birincil içeriği gösteren composable
• supportingPane: Ek içeriği gösteren composable

Ayrıntılı uygulama örnekleri için:

• Destek bölmesi düzeni oluşturma geliştirici kılavuzu
• supporting-pane-compose örneği

Ek kaynaklar

• Materyal Tasarım — Standart düzenler