Clases de tamaño de ventana

Las clases de tamaño de ventana son un conjunto de puntos de interrupción de viewports bien definidos que te ayudan a diseñar, desarrollar y probar diseños responsivos o adaptables. Los puntos de interrupción equilibran la simplicidad del diseño con la flexibilidad de optimizar la app para casos únicos.

Las clases de tamaño de ventana categorizan el área de visualización disponible para tu app como compacto, mediano o expandido. El ancho y la altura disponibles se clasifican por separado, por lo que en cualquier momento, tu app tiene dos clases de tamaño de ventana: una para el ancho y otra para la altura. El ancho disponible suele ser más importante que la altura disponible debido a la ubicuidad del desplazamiento vertical, por lo que la clase de tamaño de ancho de ventana probablemente sea más relevante para la IU de tu app.

Figura 1: Representaciones de clases de tamaños de ventana basadas en el ancho
Figura 2: Representaciones de clases de tamaños de ventana basadas en el alto

Como se muestra en las figuras, los puntos de interrupción te permiten seguir pensando en los diseños en términos de dispositivos y configuraciones. Cada punto de interrupción de clase de tamaño representa la mayoría de los casos en cada dispositivo típico, que puede ser un marco de referencia útil cuando piensas en la forma de tus diseños basados en puntos de interrupción.

Clase de tamaño Punto de interrupción Representación del dispositivo
Ancho compacto ancho <600 dp 99.96% de los teléfonos en orientación vertical
Ancho medio 600 dp ≤ ancho < 840 dp 93.73% de las tablets en orientación vertical

la mayoría de las pantallas internas desplegadas en orientación vertical

Ancho expandido ancho ≥840 dp 97.22% de las tablets en orientación horizontal

la mayoría de las pantallas internas desplegadas en orientación horizontal

Altura compacta altura <480 dp 99.78% de los teléfonos en orientación horizontal
Altura media 480 dp ≤ altura <900 dp 96.56% de las tablets en orientación horizontal

97.59% de los teléfonos en orientación vertical

Altura expandida altura ≥900 dp 94.25% de las tablets en orientación vertical

Si bien visualizar las clases de tamaño como dispositivos físicos puede ser útil, las clases de tamaño de ventana no están determinadas explícitamente por el tamaño de la pantalla del dispositivo. Las clases de tamaño de ventana no están diseñadas para la lógica isTablet‐type. En cambio, las clases de tamaño de ventana están determinadas por el tamaño de ventana disponible para tu aplicación, independientemente del tipo de dispositivo en el que se ejecute la app, lo que tiene dos implicaciones importantes:

  • Los dispositivos físicos no garantizan una clase específica de tamaño de ventana. El espacio de pantalla disponible para tu app puede diferir del tamaño de la pantalla del dispositivo por muchos motivos. En los dispositivos móviles, el modo de pantalla dividida puede particionar la pantalla entre dos aplicaciones. En ChromeOS, las apps para Android se pueden presentar en ventanas de formato libre cuyo tamaño puede cambiar de forma arbitraria. Los dispositivos plegables pueden tener dos pantallas de diferentes tamaños a las que se puede acceder de forma individual al plegar o desplegar el dispositivo.

  • La clase de tamaño de ventana puede cambiar durante el ciclo de vida de tu app. Mientras se ejecuta la app, los cambios de orientación del dispositivo, la realización de varias tareas a la vez y el plegado o desplegado pueden cambiar la cantidad de espacio de pantalla disponible. Como resultado, la clase de tamaño de ventana es dinámica, y la IU de tu app debería adaptarse en consecuencia.

Las clases de tamaño de ventana se asignan a los puntos de interrupción compacto, mediano y expandido en la guía de diseño de Material Design. Usa clases de tamaño de ventana para tomar decisiones de diseño de aplicaciones de alto nivel, como decidir si usar un diseño canónico específico para aprovechar el espacio adicional en la pantalla.

You can compute the current WindowSizeClass using the currentWindowAdaptiveInfo top‑level function of the androidx.compose.material3.adaptive library. The following example shows how to calculate the window size class and receive updates whenever the window size class changes:

val windowSizeClass = currentWindowAdaptiveInfo().windowSizeClass

Cómo administrar diseños con clases de tamaño de ventana

Las clases de tamaño de ventana te permiten cambiar el diseño de tu app a medida que cambia el espacio de visualización disponible para ella, por ejemplo, cuando un dispositivo se pliega o se despliega, cambia su orientación o se cambia el tamaño de la ventana de la app en el modo multiventana.

Para localizar la lógica con el objetivo de controlar los cambios en el tamaño de la pantalla, pasa las clases de tamaño de ventana como estado a elementos componibles anidados, como cualquier otro estado de la app:

@OptIn(ExperimentalMaterial3AdaptiveApi::class)
@Composable
fun MyApp(
    windowSizeClass: WindowSizeClass = currentWindowAdaptiveInfo().windowSizeClass
) {
    // Perform logic on the size class to decide whether to show the top app bar.
    val showTopAppBar = windowSizeClass.windowHeightSizeClass != WindowHeightSizeClass.COMPACT

    // MyScreen knows nothing about window sizes, and performs logic based on a Boolean flag.
    MyScreen(
        showTopAppBar = showTopAppBar,
        /* ... */
    )
}

Cómo probar las clases de tamaño de ventana

A medida que realices cambios en el diseño, prueba su comportamiento en todos los tamaños de ventana, especialmente en los anchos de puntos de interrupción compacto, medio y expandido.

Si ya tienes un diseño para pantallas compactas, primero optimiza tu diseño para la clase de tamaño de ancho expandido, ya que esta clase de tamaño proporciona el mayor espacio para cambios adicionales de contenido y de IU. Luego, decide qué diseño es conveniente para la clase de tamaño mediano. Considera agregar un diseño especializado.

Próximos pasos

Si deseas obtener más información para usar las clases de tamaño de ventana a fin de crear diseños responsivos o adaptables, consulta lo siguiente:

Para obtener más información sobre los aspectos que hacen que una app sea excelente en todos los dispositivos y tamaños de pantalla, consulta los siguientes artículos: