La postura de mesa en dispositivos plegables divide una sola pantalla en dos áreas de visualización funcionales separadas por el pliegue físico (o bisagra). La postura de mesa te permite colocar el contenido principal de tu app (como un reproductor de video o un lienzo de juego) en la mitad superior, mientras que los elementos interactivos (como los controles multimedia o los paneles de control) se ubican en la mitad inferior.
Prácticas recomendadas
Para agregar compatibilidad con el modo de mesa a tu app, usa la API de Grid para definir un diseño con dos filas y una columna, y aplica la consulta de medios de postura de la ventana de mesa.
- Detecta la postura de mesa de forma reactiva: Usa el elemento componible
mediaQuerypara observar el estado del dispositivo. Cuando el dispositivo se pliega en posición de mesa (windowPosture == Posture.Tabletop), cambia dinámicamente el diseño sin necesidad de reiniciar la actividad ni de controlar el ciclo de vida de forma compleja. - Estructura los diseños con
Grid: Cuando el dispositivo esté en posición de mesa, usa la API deGrid(2 rows,1 column) para separar de forma clara el contenido visual principal en la fila superior, en la mitad superior de la página, y los controles interactivos en la fila inferior, en la mitad inferior de la página. - Aprovecha la indexación z implícita para las superposiciones: En las posiciones estándar (que no son de mesa), asigna varios IDs de área a la misma celda para superponer los controles sobre el reproductor.
Gridrenderiza automáticamente los elementos de atrás hacia adelante en su orden de declaración. - Proporciona transiciones fluidas: Asegúrate de que se conserven el estado y las posiciones de desplazamiento cuando se realicen transiciones entre los diseños estándar de pantalla completa y la postura de mesa.
Ingredientes
Grid: Es un contenedor de diseño adaptable que te permite colocar elementos en filas y columnas configurables, lo que es ideal para dividir el contenido en distintas regiones de la pantalla.mediaQuery: Es una API de Jetpack Compose que se usa para consultar la postura actual de la ventana de la app, las clases de tamaño y las características del hardware directamente en tus elementos componibles.
Pasos
Consulta la postura del dispositivo con mediaQuery(). Cuando el dispositivo esté en posición de mesa, organiza el contenido de tu app en una cuadrícula vertical con dos filas y una columna, y asegúrate de que el contenido principal permanezca en la parte superior y los controles estén accesibles en la parte inferior.
1. Define las configuraciones de Grid para el modo de mesa
Dentro de una función de componibilidad, define los IDs de las áreas de diseño con un enum y configura bloques GridConfigurationScope para las posiciones predeterminada y de mesa.
En defaultConfig, ambas áreas se asignan a la misma celda (row = 1, column = 1). Grid usa la indexación z implícita, en la que los elementos de componibilidad declarados más adelante en el diseño se renderizan sobre los anteriores, lo que permite que el controlador se superponga al reproductor sin anidamiento de contenedores adicional (consulta Superposiciones de elementos de la IU con Grid para obtener más detalles).
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. Detecta la postura de mesa y aplica la configuración a Grid
Usa mediaQuery para seleccionar la configuración activa según windowPosture, pasa config a Grid y enlaza el contenido componible a los IDs de área. Declarar VideoPlayerArea.Player antes de VideoPlayerArea.Controller garantiza que, cuando ambos compartan una celda en defaultConfig, los controles se rendericen por encima del reproductor:
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 } }
Resultados
Si combinas mediaQuery y Grid, tu app detectará de forma dinámica cuando un dispositivo plegable esté parcialmente plegado en la posición de mesa y ajustará automáticamente su IU en dos áreas de visualización funcionales divididas por el pliegue.
Recursos adicionales
- Comienza a usar apps adaptables
- Cómo agregar compatibilidad con modos de pantalla plegable
- Superposiciones de elementos de la IU con cuadrícula