使用視窗大小類別

視窗大小類別是一組自主的可視區域中斷點，有助於設計、開發及測試回應式/自動調整式版面配置。這些中斷點可讓版面配置保持簡單又兼具彈性，進一步根據獨特的情境需求來最佳化應用程式。

視窗大小類別會將應用程式的可用顯示區域分類為「精簡」、「中等」、「展開」、「大型」或「特大型」。可用寬度和高度會另外分類，因此應用程式隨時都有兩種視窗大小類別：寬度類別和高度類別。一般來說，可用的寬度會比高度重要，這是因為直向捲動操作比較常見，因此寬度的視窗大小類別應該對應用程式使用者介面設定更有用。

如圖所示，中斷點可讓您繼續考量裝置與設定的版面配置。每個大小類別中斷點都代表了典型裝置情境的大部分案例，當您考慮設計以中斷點為基礎的版面配置時，這個參考框架便可以派上用場。

雖然以實體裝置呈現大小類別有時很有幫助，但視窗大小類別並非明確取決於裝置螢幕大小。視窗大小類別不適用於 isTablet 類型的邏輯。視窗大小類別取決於應用程式可用的視窗大小，且不考量執行應用程式的裝置類型，這會造成兩個重要結果：

• 實體裝置不能保證特定的視窗大小類別。由於許多因素影響，應用程式能使用的螢幕空間可能不同於裝置螢幕大小。在行動裝置上，分割畫面模式可讓兩個應用程式同時在螢幕上顯示。在 ChromeOS 中，Android 應用程式會顯示在可自由調整大小的桌面型視窗中。摺疊式裝置會因處於摺疊或未摺疊狀態，具有兩種不同大小的螢幕。

• 視窗大小類別可能在應用程式的生命週期發生變化。 執行應用程式時，變更裝置螢幕方向、進行多工處理和裝置處於摺疊/未摺疊狀態等因素，都會影響可用的螢幕空間大小。因此，視窗大小類別會動態變化，應用程式 UI 應隨之調整。

視窗大小類別會對應至Material Design 版面配置指南中的精簡、中等和展開中斷點。請使用視窗大小類別決定概略的應用程式版面配置，例如決定是否使用特定標準版面配置來善用額外的螢幕空間。

使用WindowSizeClass currentWindowAdaptiveInfo() 的顶层函数 androidx.compose.material3.adaptive 库。该函数返回一个 WindowAdaptiveInfo 的实例，其中包含 windowSizeClass。通过 以下示例展示了如何计算窗口大小类别并接收 会在窗口大小类别发生变化时更新：

val windowSizeClass = currentWindowAdaptiveInfo().windowSizeClass
AdaptiveLayoutSnippets.kt

使用窗口大小类别管理布局

通过窗口大小类别，您可以将应用布局更改为显示空间 更改，例如当设备折叠或展开时， 设备屏幕方向发生变化，或者应用窗口在多窗口模式下被调整大小 模式。

通过传递窗口大小，将用于处理显示屏大小变化的逻辑本地化 像任何其他应用状态一样，将类作为状态向下传递到嵌套可组合项：

@Composable
fun MyApp(
    windowSizeClass: WindowSizeClass = currentWindowAdaptiveInfo().windowSizeClass
) {
    // Decide whether to show the top app bar based on window size class.
    val showTopAppBar = windowSizeClass.isHeightAtLeastBreakpoint(WindowSizeClass.HEIGHT_DP_MEDIUM_LOWER_BOUND)

    // MyScreen logic is based on the showTopAppBar boolean flag.
    MyScreen(
        showTopAppBar = showTopAppBar,
        /* ... */
    )
}
AdaptiveLayoutSnippets.kt

測試視窗大小類別

變更版面配置時，請測試所有視窗大小下的版面配置行為，尤其是精簡、中等及展開中斷點寬度。

如果現有版面配置適用於精簡螢幕，請先針對展開寬度大小類別將版面配置最佳化，因為這個大小會為其他內容及 UI 變更提供最多空間。接下來，再決定哪種版面配置適合中等寬度大小類別，並考慮加入專用版面配置。

後續步驟

如要進一步瞭解如何使用視窗大小類別建立回應式/自動調整式版面配置，請參閱下列內容：

• 以 Compose 為基礎的版面配置：支援不同的螢幕大小

• 以 View 為基礎的版面配置：請參閱「使用檢視區塊打造回應式/自動調整設計」

如要進一步瞭解如何讓應用程式在所有裝置和螢幕大小上提供良好體驗，請參閱：

• 將 UI 改為回應式版面配置
• 大螢幕應用程式品質