窗口大小类别

窗口大小类别是一组主观的视口断点 设计、开发和测试响应式/自适应布局。断点平衡 让布局简单明了，可以灵活地针对独特情形优化应用。

窗口大小类别将可供应用使用的显示区域分类为 compact、medium 或 expanded。可用宽度和高度进行分类 因此在任何时间点，应用都有两个窗口大小 类，一个用于宽度，一个用于高度。可用宽度通常更大 由于垂直滚动的普遍存在，“高度”比可用高度重要， 宽度窗口大小类别很可能与应用的界面更相关。

图 1. 基于宽度的窗口大小类别的表示。
图 2. 基于高度的窗口大小类别图示。

如图所示，这些断点可让你继续思考 从设备和配置角度考虑布局每个大小类别划分点代表了典型设备场景的大多数情况，当您考虑基于划分点的布局设计时，这可能是一个有用的参考框架。

大小类别 划分点 设备表示
较小的宽度 宽度 < 600dp 99.96% 的手机处于竖屏模式
中等宽度 600dp ≤ 宽度 < 840dp 93.73% 的平板电脑处于竖屏模式，

大多数展开后的纵向内屏
较大宽度 宽度 ≥ 840dp 97.22% 的平板电脑处于横屏模式，

大多数展开后的横向大型内部显示屏
较小的高度 高度 < 480dp 99.78% 的手机处于横屏模式
中等高度 480dp ≤ 高度 < 900dp 96.56% 的平板电脑处于横屏模式，

97.59% 的手机处于竖屏模式
展开高度 高度 ≥ 900dp 94.25% 的平板电脑处于竖屏模式

虽然将大小类别可视化为实体设备可能很有用，但窗口大小 类并非由设备屏幕的尺寸明确决定。窗户 大小类不适用于 isTablet 类型的逻辑。相反，窗口 大小类别由应用可用的窗口大小决定 无论在哪种类型的设备上运行应用 影响：

  • 实体设备不能保证特定的窗口大小类别。通过 应用的可用屏幕空间可能不同于 导致这种情况的原因有很多在移动设备上，分屏模式可以 用于在两个应用之间划分屏幕。在 ChromeOS 上，Android 应用 显示在可任意调整大小的自由式窗口中。 可折叠设备可以分别访问两个不同尺寸的屏幕 展示您的应用。

  • 窗口大小类别在应用的整个生命周期内可能会发生变化。 当应用运行时，设备屏幕方向会发生变化、多任务处理以及 折叠/展开可能会改变可用的屏幕空间大小。作为 因此，窗口大小类别是动态的，应用的界面应调整 。

窗口大小类别映射到 Material Design 布局 指南。 使用窗口大小类别做出高级应用布局决策， 例如，决定是否使用特定的规范布局来利用 增加屏幕空间

Compute the current WindowSizeClass using the currentWindowAdaptiveInfo() top‑level function of the androidx.compose.material3.adaptive library. The function returns an instance of WindowAdaptiveInfo, which contains windowSizeClass. The following example shows how to calculate the window size class and receive updates whenever the window size class changes:

val windowSizeClass = currentWindowAdaptiveInfo().windowSizeClass
AdaptiveLayoutSnippets.kt

Manage layouts with window size classes

Window size classes enable you to change your app layout as the display space available to your app changes, for example, when a device folds or unfolds, the device orientation changes, or the app window is resized in multi‑window mode.

Localize the logic for handling display size changes by passing window size classes down as state to nested composables just like any other app state:

@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,
        /* ... */
    )
}
AdaptiveLayoutSnippets.kt

测试窗口大小类别

在更改布局时，请测试所有窗口大小的布局行为， 尤其是在较小、中等和较大断点宽度下。

如果您已有适用于较小屏幕的现有布局，请先优化布局 因为此尺寸类别提供的空间最大 了解更多内容和界面变化。然后确定适合的布局 中等宽度大小类别请考虑添加专用布局

后续步骤

详细了解如何使用窗口大小类别创建响应式/自适应式 请参阅以下内容：

如需详细了解如何让应用在所有设备上以及所有屏幕尺寸下都表现出色， 请参阅：

上一页
支持不同的屏幕尺寸
下一页
支持多窗口模式