標準版面配置是經過實證、功能多元的版面配置,可為各種板型規格提供最佳使用者體驗。

標準版面配置支援小螢幕手機、平板電腦、摺疊式裝置和 ChromeOS 裝置。這些版面配置是根據 Material Design 指南所設計,美觀又實用。
Android 架構包含特殊的元件,可直觀可靠地實作版面配置。
標準化版面配置可建立引人入勝、提升工作效率的 UI,奠定卓越應用程式的基礎。
清單詳細資料

藉助清單詳細資料版面配置,使用者可探索具有描述性、解釋性或其他補充資訊的項目清單,例如作品詳細資料。
此版面配置將應用程式視窗分為兩個並排的窗格:一個用於清單,另一個用於詳細資料。使用者從清單中選取項目,即可顯示作品詳細資料。 詳細資料中的深層連結會顯示詳細資料窗格中的其他內容。
展開寬度螢幕 (請參閱「使用視窗大小類別」) 可同時顯示清單和詳細資料。選取清單項目,即可更新詳細資料窗格,顯示所選項目的相關內容。
寬度中等和較窄的螢幕會依照使用者與應用程式的互動情況,顯示清單或詳細資料。僅顯示清單時,選取某個清單項目會使畫面改為顯示詳細資料,不再顯示清單。僅顯示詳細資訊時,按下返回按鈕即可重新顯示清單。
設定變更 (例如裝置螢幕方向變更或應用程式視窗大小變更) 則會改變螢幕的視窗大小類別。清單詳細資料版面配置會據此回應,保留應用程式狀態:
- 展開寬度螢幕同時顯示清單和詳細資料窗格時,若其縮小為中等或密集,詳細資料窗格仍會繼續顯示,而清單窗格則會隱藏起來
- 如果寬度為中等或較窄小的螢幕僅顯示詳細資料窗格,且視窗大小類別擴大為展開狀態,清單和詳細資料則會同時顯示,而清單則會指出已選取與詳細資料窗格中內容對應的項目
- 如果寬度為中等或較窄小的螢幕僅顯示清單窗格,並擴大為展開狀態,清單和預留位置詳細資料窗格會同時顯示
清單/詳細資料很適合用於訊息應用程式、聯絡人管理工具、互動式媒體瀏覽器,或是任何可將內容整理成項目清單的形式來顯示額外資訊的應用程式。
實作
Compose 的宣告式範例支援視窗大小類別邏輯,可判斷是否要同時顯示清單和詳細資料窗格 (展開寬度視窗大小類別時),或僅顯示清單或詳細資料窗格 (寬度視窗大小類別為中等或較窄小時)。
如要確保單向資料流,請提升所有狀態,包括目前的視窗大小類別和所選清單項目的詳細資料 (如果有的話),以便所有可組合項均能存取資料並正確算繪。
如果僅在小型視窗上顯示詳細資料窗格,請新增 BackHandler 以移除詳細資料窗格,並只顯示清單窗格。由於處理常式取決於視窗大小類別和所選的詳細資料狀態,因此 BackHandler 不屬於整體應用程式導覽的一部分。
ListDetailPaneScaffold 是高階可組合函式,可簡化清單詳細資料版面配置的實作。這項功能會根據視窗大小類別自動處理窗格邏輯,並支援窗格之間的導覽。
以下是使用 ListDetailPaneScaffold 的最簡單實作方式:
@OptIn(ExperimentalMaterial3AdaptiveApi::class) @Composable fun MyListDetailPaneScaffold() { val navigator = rememberListDetailPaneScaffoldNavigator() ListDetailPaneScaffold( directive = navigator.scaffoldDirective, value = navigator.scaffoldValue, listPane = { // Listing Pane }, detailPane = { // Details Pane } ) }
以下是這個範例中的重要元件:
rememberListDetailPaneScaffoldNavigator:建立導覽器,管理清單和詳細資料窗格之間的導覽。listPane:顯示項目清單。detailPane:顯示所選項目的內容。
如需詳細的實作範例,請參閱:
- 建構清單/詳細資料版面配置開發人員指南
- list-detail-compose 清單/詳細資料撰寫範例
動態消息

動態消息版面配置會在可設定格線中,排列對等的內容元素,以便快速檢視大量內容。
大小和位置建立內容元素之間的關係。
內容群組的建立方式是建立相同大小的元素並放在一起。讓這些元素比鄰近元素還要大,藉此吸引對於元素的注意。
資訊卡和清單是動態提醒版面配置的常見元件。
動態消息版面配置幾乎可支援所有螢幕尺寸,因為這種配置方式可調整內容顯示格框,單欄或多欄捲動都沒問題。
動態消息特別適合新聞和社群媒體應用程式。
實作
Feed 包含大量内容元素,这些内容元素位于一个纵向滚动容器中,而该容器采用网格布局。延迟列表可高效地在列或行中呈现大量的项。延迟网格以网格形式呈现项,支持配置项的大小和 span。
根据可用的显示区域配置网格布局的列,以设置网格项允许的最小宽度。定义网格项时,只需调整列 span 即可让某些项比其他项更为醒目。
对于部分标题、分隔线或要占据 Feed 的整个宽度的其他项,请使用 maxLineSpan 占据布局的整个宽度。
如果较小宽度的显示屏没有足够的空间来显示一个以上的列,LazyVerticalGrid 就会像 LazyColumn 一样运行。
以下是使用 LazyVerticalGrid 的最小实现:
@Composable fun MyFeed(names: List<String>) { LazyVerticalGrid( // GridCells.Adaptive automatically adapts column count based on available width columns = GridCells.Adaptive(minSize = 180.dp), ) { items(names) { name -> Text(name) } } }
自适应 Feed 的关键在于 columns 配置。GridCells.Adaptive(minSize = 180.dp) 会创建一个网格,其中每列至少为 180.dp 宽。然后,网格会显示可用空间中可容纳的列数。
如需查看示例实现,请参阅使用 Compose 构建 Feed 示例。
輔助窗格

輔助窗格版面配置會將應用程式內容整理成主要和次要顯示區域。
主要顯示區域會占用應用程式視窗的大部分空間 (通常約三分之二),用於呈現主要內容。次要顯示區域是窗格,會占用應用程式視窗的其餘部分,並呈現主要內容的輔助內容。
輔助窗格版面配置非常適合橫向的展開寬度螢幕 (請參閱「使用視窗大小類別」)。中等或精簡寬度螢幕支援顯示主要和次要顯示區域,前提是內容可根據更窄的顯示空間調整,或其他內容最初可隱藏在底部或側邊工作表中 (以選單或按鈕等控制項存取)。
就主要和次要內容的關係而言,輔助窗格版面配置不同於清單詳細資料版面配置。在輔助窗格版面配置中,次要窗格內容只因與主要內容相關而有意義。舉例來說,輔助窗格工具視窗本身並不重要。不過,即使沒有主要內容 (例如產品資訊中的產品說明),在清單詳細資料版面配置的詳細資料窗格中的補充內容也仍然有意義。
輔助窗格的用途如下:
- 效率提升應用程式:在文件或試算表中以輔助窗格呈現評論者留言
- 媒體應用程式:在串流影片中以輔助窗格中呈現相關影片清單,或在音樂專輯說明旁顯示播放清單
- 工具和設定:輔助窗格中的媒體編輯工具,包含調色盤、效果和其他設定
實作
Compose 支援視窗大小類別邏輯,可讓您判斷要同時顯示主要內容和輔助內容,或將輔助內容放在替代位置。
提升所有狀態,包括目前的視窗大小類別,以及與主要內容和輔助內容資料相關的資訊。
如果是寬度較窄的螢幕,請將輔助內容放在主要內容下方或底部功能表中。如果是中等和展開寬度,請將輔助內容放在主要內容旁,並根據可用的內容和空間適當調整大小。如果是中等寬度,請將顯示空間平分給主要內容和輔助內容。如果是展開寬度,請將 70% 的空間留給主要內容,30% 分給輔助內容。
SupportingPaneScaffold 是高階可組合函式,可簡化輔助窗格版面配置的實作。可組合函式會根據視窗大小類別自動處理窗格邏輯,在大螢幕上並排顯示窗格,或在小螢幕上隱藏輔助窗格。SupportingPaneScaffold 也支援在窗格之間導覽。
以下是最簡單的實作方式:
@OptIn(ExperimentalMaterial3AdaptiveApi::class) @Composable fun MySupportingPaneScaffold() { // Creates and remembers a navigator to control pane visibility and navigation val navigator = rememberSupportingPaneScaffoldNavigator() SupportingPaneScaffold( // Directive and value help control pane visibility based on screen size and state directive = navigator.scaffoldDirective, value = navigator.scaffoldValue, mainPane = { // Main Pane for the primary content }, supportingPane = { //Supporting Pane for supplementary content } ) }
rememberSupportingPaneScaffoldNavigator:可建立導覽器的可組合函式,用於管理窗格顯示設定 (例如在精簡螢幕上隱藏或顯示輔助窗格)mainPane:顯示主要內容的可組合函式supportingPane:顯示補充內容的可組合函式
如需詳細的實作範例,請參閱:
- 建構輔助窗格版面配置開發人員指南
- supporting-pane-compose 範例
其他資源
- Material Design:標準化版面配置