Postur di atas meja pada perangkat foldable membagi satu layar menjadi dua area tampilan fungsional yang dipisahkan oleh lipatan (atau engsel) fisik. Postur di atas meja memungkinkan Anda menempatkan konten utama aplikasi (seperti pemutar video atau kanvas game) di paruh atas, sekaligus memosisikan elemen interaktif (seperti kontrol media atau pad kontrol) di paruh bawah.
Praktik terbaik
Untuk menambahkan dukungan mode di atas meja ke aplikasi Anda, gunakan Grid API untuk menentukan tata letak dengan dua baris dan satu kolom, serta terapkan kueri media postur jendela mode di atas meja.
- Mendeteksi postur mode di atas meja secara reaktif: Gunakan composable
mediaQueryuntuk mengamati status perangkat. Saat perangkat dilipat ke postur di atas meja (windowPosture == Posture.Tabletop), ubah tata letak Anda secara dinamis tanpa memerlukan mulai ulang aktivitas atau penanganan siklus proses yang kompleks. - Struktur tata letak dengan
Grid: Saat dalam mode di atas meja, gunakanGridAPI (2 rows,1 column) untuk memisahkan konten visual utama dengan jelas ke baris atas di paruh atas dan kontrol interaktif ke baris bawah di paruh bawah. - Manfaatkan pengindeksan z implisit untuk overlay: Dalam postur standar (non-mode di atas meja), tetapkan beberapa ID area ke sel yang sama untuk menempatkan kontrol di atas pemutar.
Gridotomatis merender item dari belakang ke depan sesuai urutan deklarasinya. - Menyediakan transisi yang mulus: Pastikan status dan posisi scroll dipertahankan saat beralih antara tata letak layar penuh standar dan postur di atas meja.
Bahan
Grid: Penampung tata letak adaptif yang memungkinkan Anda memosisikan item dalam baris dan kolom yang dapat dikonfigurasi, ideal untuk membagi konten di berbagai area layar.mediaQuery: Jetpack Compose API yang digunakan untuk mengkueri postur jendela, class ukuran, dan karakteristik hardware aplikasi saat ini langsung dalam composable Anda.
Langkah
Buat kueri postur perangkat menggunakan mediaQuery(). Saat perangkat dalam postur mode di atas meja, atur konten aplikasi Anda ke dalam petak vertikal dengan dua baris dan satu kolom, sehingga memastikan konten utama tetap berada di atas dan kontrol tetap dapat diakses di bagian bawah.
1. Menentukan konfigurasi petak untuk mode di atas meja
Di dalam fungsi composable, tentukan ID area tata letak menggunakan enum dan siapkan blok GridConfigurationScope untuk postur default dan mode di atas meja.
Di defaultConfig, kedua area ditetapkan ke sel yang sama (row = 1, column = 1). Grid menggunakan pengindeksan z implisit, dengan composable yang dideklarasikan nanti dalam tata letak dirender di atas composable sebelumnya, sehingga pengontrol dapat menempatkan overlay di atas pemutar tanpa penyusunan bertingkat container tambahan (lihat Overlay elemen UI dengan Grid untuk mengetahui detail selengkapnya).
enum class VideoPlayerArea { Player, Controller } object PlayerGridConfig { // Default: Single area layout with overlay (controls on top of player) val defaultConfig: GridConfigurationScope.() -> Unit = { row(1f) column(1f) area(areaId = VideoPlayerArea.Player, row = 1, column = 1) area(areaId = VideoPlayerArea.Controller, row = 1, column = 1) } // Tabletop: Two rows splitting content across the fold val tabletopConfig: GridConfigurationScope.() -> Unit = { row(0.5f) row(0.5f) column(1f) area(areaId = VideoPlayerArea.Player, row = 1, column = 1) // Top half above fold area(areaId = VideoPlayerArea.Controller, row = 2, column = 1) // Bottom half below fold } }
2. Mendeteksi postur di atas meja dan menerapkan konfigurasi ke Petak
Gunakan mediaQuery untuk memilih konfigurasi aktif berdasarkan windowPosture, teruskan config ke Grid, dan ikat konten composable ke ID area. Mendeklarasikan VideoPlayerArea.Player sebelum VideoPlayerArea.Controller memastikan bahwa saat keduanya berbagi sel di defaultConfig, kontrol akan dirender di atas pemutar:
val config = mediaQuery { when (windowPosture) { Posture.Tabletop -> PlayerGridConfig.tabletopConfig else -> PlayerGridConfig.defaultConfig } } Grid(config = config) { Box( modifier = Modifier .gridItem(areaId = VideoPlayerArea.Player) ) { // VideoPlayerContent } Box( modifier = Modifier .gridItem(areaId = VideoPlayerArea.Controller) ) { // PlaybackControlsContent } }
Hasil
Dengan menggabungkan mediaQuery dan Grid, aplikasi Anda akan secara dinamis mendeteksi saat perangkat foldable dilipat sebagian ke postur di atas meja dan otomatis menyesuaikan UI-nya menjadi dua area tampilan fungsional yang dipisahkan oleh lipatan.
Referensi lainnya
- Mulai menggunakan aplikasi adaptif
- Mendukung mode tampilan perangkat foldable
- Overlay elemen UI dengan Grid