本頁面由 Cloud Translation API 翻譯而成。

Compose Material3 自動調整

API 參考資料
androidx.compose.material3.Adaptive

使用 Material 3 自動調整式程式庫建立自動調整式 UI 會根據目前的視窗自動調整例如視窗大小類別或裝置型態這個程式庫提供預設的 Scaffold 實作，以及必要的建構區塊可組合項打造專屬體驗

最近更新時間	穩定版	候選版	Beta 版	Alpha 版
2024 年 9 月 4 日	1.0.0	-	-	1.1.0-alpha02

宣告依附元件

如要新增 Compose 的依附元件，必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

dependencies {
    implementation "androidx.compose.material3.adaptive:adaptive:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-layout:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-navigation:1.1.0-alpha02"
}

Kotlin

dependencies {
    implementation("androidx.compose.material3.adaptive:adaptive:1.1.0-alpha02")
    implementation "androidx.compose.material3.adaptive:adaptive-layout:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-navigation:1.1.0-alpha02"
}

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件。

Compose Material3 自動調整版本 1.1

1.1.0-alpha02 版本

2024 年 9 月 4 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha02。1.1.0-alpha02 版包含這些修訂版本。

新功能

製造商支援動作自訂 (I0bf9c)、(I80e66)，可在自動調整 Scaffold 狀態期間變更預設動作。製作者可以選用一組預設的進出轉場，或是以新的動態範圍所提供的資訊，導入純自訂轉場效果。
實作窗格展開拖曳控點的淡出動畫 (46e3c69)
將記憶的 PaneExpansionState 設為可儲存 (61ff76f)

API 變更

將缺少的窗格展開 APis 新增至 Scaffolds (Ic5bc0)
ThreePaneScaffoldDestinationItem.content 已重新命名為 contentKey。rememberListDetailPaneScaffoldNavigator 和 rememberSupportingPaneScaffoldNavigator 預設類型引數已從 Nothing 變更為 Any。(I58749)。
將 ThreePaneScaffoldState 標示為穩定版 (I64aec)
將拖曳控點參數限定範圍 (Ic0aa2)

1.1.0-alpha01 版本

2024 年 8 月 21 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha01。1.1.0-alpha01 版包含這些修訂版本。

新功能

引入對適應性 Scaffold 的窗格展開支援。

API 變更

將窗格擴充 API 引入公開 (I301d6)
引入 ThreePaneScaffoldState 來控制窗格值轉換。新增了接受此狀態的 ListDetailPaneScaffold 和 SupportingPaneScaffold 超載。(I5db3b)。
介紹窗格展開鍵和金鑰提供者介面 (Id621f)

修正錯誤

修正排除轉軸時的錯誤分區計算錯誤。(9dfd483)。

Compose Material3 自動調整版本 1.0

1.0.0 版本

2024 年 9 月 4 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0。1.0.0 版包含這些修訂版本。

1.0.0 的主要功能

單行可組合函式 currentWindowSize()、collectFoldingFeaturesAsState() 和 currentWindowAdaptiveInfo() 可取得調整應用程式所需的視窗資訊，例如視窗大小和折疊功能。
ListDetailPaneScaffold 和 SupportingPaneScaffold 提供兩個 Material3 標準版面配置，可自動根據不同的視窗設定自動調整。這兩種 Scaffold 也能完全根據製造商的不同需求進行自訂。
ThreePaneScaffoldNavigator 及其相關的 remember 函式 rememberListDetailPaneScaffoldNavigator() 和 rememberSupportingPaneScaffoldNavigator() 在自動調整的 Scaffold 中提供導覽解決方案，該功能可以同時顯示多個導覽目的地，與無法自動調整世界中常見的一次性設定比較結果。
變更自動調整式 Scaffold 狀態時的預設內建 Material3 動畫。

1.0.0-rc01 版

2024 年 8 月 21 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-rc01。1.0.0-rc01 版包含這些修訂版本。

修正錯誤

修正排除轉軸時的錯誤分區計算錯誤。(9dfd483)。

1.0.0-beta04 版

2024 年 6 月 26 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta04。1.0.0-beta04 版包含這些修訂版本。

修正錯誤

修正在轉軸邊界更新時，版面配置不會跟著更新的問題。(71e9cf1)。

1.0.0-beta03 版

2024 年 6 月 12 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta03。1.0.0-beta03 版包含這些修訂版本。

修正錯誤

修正 Beta02 中依附元件解決方案錯誤導致的當機問題。

1.0.0-beta02 版

2024 年 5 月 29 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta02。1.0.0-beta02 版包含這些修訂版本。

1.0.0-beta01 版

2024 年 5 月 14 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta01。1.0.0-beta01 版包含這些修訂版本。

1.0.0-alpha12 版

2024 年 5 月 1 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha12。1.0.0-alpha12 版包含這些修訂版本。

API 變更

在 HingeInfo 中新增 isFlat 資訊 (Ie0516、b/333784198)
將自動調整式 API 設為非實驗性質 (I1d038)
將自動調整版面配置 API 設為非實驗性質 (Id23df)
將 BackNavigationBehavior 從列舉變更為值類別 (Id8757)

修正錯誤

將轉場比例變更為 lambda (I6f5a9)
修正 SizeTracker 的初始狀態問題 (18326a9)
在 Posture 等式檢查中加入轉軸清單 (6687137)

1.0.0-alpha11 版本

2024 年 4 月 17 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha11。1.0.0-alpha11 版包含這些修訂版本。

API 變更

將範圍介面設為密封。(Iefa57)。
導入 AnimatedPaneScope。(I62d73、b/332750742)
將 AdaptStrategy 密封且保持穩定。(Ia28b2)。
導入 PaneScaffoldDirective 的複製方法。(I9291f)。
將 ThreePaneScaffoldScope 標示為實驗功能。(I9d527)。
提供易於使用的 Scaffold API，以便支援導覽功能。(I263f0、b/321010778)

1.0.0-alpha10 版本

2024 年 4 月 3 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha10。1.0.0-alpha10 版包含這些修訂版本。

API 變更

將預設寬度設為自動調整與可自訂。(Ic3abc)。
重新命名 scaffold 指令計算函式。(I10855)。
移除 scaffold API 中的邊框間距和插邊。(I786f8)。
新增不含一般類型的導覽器 remember 方法。(I607c3)。

1.0.0-alpha09 版本

March 20, 2024

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha09。1.0.0-alpha09 版包含這些修訂版本。

API 變更

將狀態轉換欄位新增至 ThreePaneScaffoldScope。(I3d917)。
重新排序 Scaffold 參數。(I4dff5)。
請提供 AnimatedPane 修飾符參數的預設值。(I77dd7)。

修正錯誤

在窗格動作中加入空格字元大小。(a3174ca)。

1.0.0-alpha08 版本

2024 年 3 月 6 日

發布 androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha08。1.0.0-alpha08 版包含這些修訂版本。

新功能

實作在切換窗格時延遲滑行的做法。(I1a38e)。

API 變更

已移除 ThreePaneScaffoldState 介面。(I63f23)。

1.0.0-alpha07 版本

2024 年 2 月 21 日