La position Écran à plat sur les appareils pliables divise un écran unique en deux zones d'affichage fonctionnelles séparées par le pli physique (ou la charnière). La position Écran à plat vous permet de placer le contenu principal de votre application (comme un lecteur vidéo ou un canevas de jeu) sur la moitié supérieure, tout en positionnant les éléments interactifs (comme les commandes multimédias ou les manettes de contrôle) sur la moitié inférieure.
Bonnes pratiques
Pour ajouter la compatibilité avec l'écran à plat à votre application, utilisez l'API Grid pour définir une mise en page avec deux lignes et une colonne, puis appliquez la requête média de posture de fenêtre d'écran à plat.
- Détecter la position sur table de manière réactive : utilisez le composable
mediaQuerypour observer l'état de l'appareil. Lorsque l'appareil est plié en mode Écran à plat (windowPosture == Posture.Tabletop), modifiez dynamiquement votre mise en page sans avoir à redémarrer l'activité ni à gérer un cycle de vie complexe. - Structurer les mises en page avec
Grid: en position sur table, utilisez l'APIGrid(2 rows,1 column) pour séparer clairement le contenu visuel principal dans la ligne supérieure au-dessus de la pliure et les commandes interactives dans la ligne inférieure en dessous de la pliure. - Utilisez l'indexation Z implicite pour les superpositions : dans les postures standards (autres que sur table), attribuez plusieurs ID de zone à la même cellule pour superposer les commandes sur le lecteur.
Gridaffiche automatiquement les éléments de l'arrière vers l'avant dans l'ordre de leur déclaration. - Fournissez des transitions fluides : assurez-vous que l'état et les positions de défilement sont conservés lors de la transition entre les mises en page plein écran standards et la position sur table.
Ingrédients
Grid: conteneur de mise en page adaptatif qui vous permet de positionner des éléments dans des lignes et des colonnes configurables, idéal pour diviser le contenu entre différentes régions de l'écran.mediaQuery: API Jetpack Compose permettant d'interroger la position actuelle de la fenêtre de l'application, les classes de taille et les caractéristiques matérielles directement dans vos composables.
Étapes
Interrogez la stratégie de l'appareil à l'aide de mediaQuery(). Lorsque l'appareil est en position écran à plat, organisez le contenu de votre application dans une grille verticale comportant deux lignes et une colonne, en veillant à ce que le contenu principal reste en haut et que les commandes restent accessibles en bas.
1. Définir les configurations de grille pour le mode sur table
Dans une fonction composable, définissez les ID des zones de mise en page à l'aide d'un enum et configurez des blocs GridConfigurationScope pour les postures par défaut et écran à plat.
Dans defaultConfig, les deux zones sont attribuées à la même cellule (row = 1, column = 1). Grid utilise l'indexation Z implicite, où les composables déclarés plus tard dans la mise en page sont affichés au-dessus des précédents, ce qui permet au contrôleur de se superposer au lecteur sans imbrication de conteneurs supplémentaires (voir Superpositions d'éléments d'interface utilisateur avec Grid pour en savoir plus).
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. Détecter la position de l'écran à plat et appliquer la configuration à la grille
Utilisez mediaQuery pour sélectionner la configuration active en fonction de windowPosture, transmettez config à Grid et associez le contenu composable aux ID de zone. Déclarer VideoPlayerArea.Player avant VideoPlayerArea.Controller garantit que lorsque les deux partagent une cellule dans defaultConfig, les commandes s'affichent au-dessus du lecteur :
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 } }
Résultats
En combinant mediaQuery et Grid, votre application détecte de manière dynamique quand un appareil pliable est partiellement plié en mode Écran à plat et ajuste automatiquement son UI en deux zones d'affichage fonctionnelles séparées par le pli.
Ressources supplémentaires
- Premiers pas avec les applications adaptatives
- Assurer la compatibilité avec les modes d'affichage des appareils pliables
- Superpositions d'éléments d'interface utilisateur avec Grid