Diseño de postura de mesa con cuadrícula y mediaQuery

Ícono de calificación de 4 estrellas

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.

Dispositivo plegable en posición de mesa que muestra contenido de video en la pantalla superior y controles de reproducción en la pantalla inferior.
Figura 1: La postura de mesa divide el contenido y los controles interactivos en el pliegue físico.

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 mediaQuery para 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 de Grid (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. Grid renderiza 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