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

Coordinatorlayout

API 參考資料
androidx.coordinatorlayout.widget

定位頂層應用程式小工具，例如 AppBarLayout 和 FloatingActionButton。

最近更新時間	穩定版	候選版	Beta 版	Alpha 版
2025 年 2 月 26 日	1.3.0	-	-	-

宣告依附元件

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

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

Groovy

dependencies {
    implementation "androidx.coordinatorlayout:coordinatorlayout:1.3.0"
}

Kotlin

dependencies {
    implementation("androidx.coordinatorlayout:coordinatorlayout:1.3.0")
}

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

意見回饋

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

建立新問題

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

1.3 版本

1.3.0 版本

2025 年 2 月 26 日

發布 androidx.coordinatorlayout:coordinatorlayout:1.3.0。1.3.0 版包含這些修訂版本。

自 1.2.0 版以來的重要異動

新功能

新增對 Page Up、Page Down、Move Home 和 Move End 按鍵事件的支援。(14719d3)
新增 RecyclerView 在 CoordinatorLayout 中 (含摺疊式應用程式列) 和 PreferenceScreen 在 CoordinatorLayout 中 (含摺疊式應用程式列) 的示範。(fca56e0、I4c679)。

修正錯誤

使用 NestedScrollView 修正 CoordinatorLayout 中的向上、向下、空格鍵和按鍵變化版本的鍵盤動作。(I216f4)。
修正在 CoordinatorLayout 中使用 recyclerview 時，鍵盤下滑時無法正確收合應用程式列的問題。(I7eac4)。

1.3.0-rc01 版本

2025 年 2 月 12 日

發布 androidx.coordinatorlayout:coordinatorlayout:1.3.0-rc01。1.3.0-rc01 版本包含這些修訂版本。

1.3.0-beta01 版本

2025 年 1 月 29 日

發布 androidx.coordinatorlayout:coordinatorlayout:1.3.0-beta01。1.3.0-beta01 版包含這些修訂版本。

1.3.0-alpha03 版

2025 年 1 月 15 日

發布 androidx.coordinatorlayout:coordinatorlayout:1.3.0-alpha03。1.3.0-alpha03 版包含這些修訂版本。

修正錯誤

這個程式庫現在使用 JSpecify 空值註解，這是類型用途。Kotlin 開發人員應使用下列編譯器引數，確保正確使用方式：-Xjspecify-annotations=strict (這是 Kotlin 編譯器 2.1.0 版起的預設值)。(I9ab25、b/326456246)。
在 CoordinatorLayout 中使用 recyclerview 時，鍵盤下方的應用程式列現在可正確收合。

1.3.0-alpha02 版本

2023 年 10 月 4 日

發布 androidx.coordinatorlayout:coordinatorlayout:1.3.0-alpha02。查看 1.3.0-alpha02 版的修訂項。

版本升級發布，與 1.3.0-alpha01 沒有差異。

1.3.0-alpha01 版本

2023 年 9 月 20 日

發布 androidx.coordinatorlayout:coordinatorlayout:1.3.0-alpha01。1.3.0-alpha01 版包含此連結所列的修訂項目。

新功能

新增對 Page Up、Page Down、Move Home 和 Move End 鍵事件的支援。(14719d3)。

API 變更

在 CoordinatorLayout.java 中新增是否可為空值註解。(Ieb647、b/236474453)。

修正錯誤

使用 NestedScrollView 和 CoordinatorLayout 修正向上、向下、空格鍵和按鍵變化版本的鍵盤動作。(bdd72e6)

1.2 版本

1.2.0 版本

2022 年 1 月 12 日

已釋出 androidx.coordinatorlayout:coordinatorlayout:1.2.0。1.2.0 版包含此連結所列的修訂項目。

自 1.1.0 版之後的重要變更

只保留 CoordinatorLayout 規則中的執行階段可見註解 (9ec7cb)

1.2.0-rc01 版本

2021 年 12 月 15 日

已釋出 androidx.coordinatorlayout:coordinatorlayout:1.2.0-rc01。1.2.0-rc01 版包含這些修訂版本。

1.2.0-beta01 版本

2021 年 11 月 17 日

發布 androidx.coordinatorlayout:coordinatorlayout:1.2.0-beta01。查看 1.2.0-beta01 版的修訂項。

API 變更

API 已推出 Beta 版。

1.2.0-alpha01 版本

2021 年 11 月 3 日

發布 androidx.coordinatorlayout:coordinatorlayout:1.2.0-alpha01。1.2.0-alpha01 版包含以下修訂項目。

修正錯誤

只保留 CoordinatorLayout 規則中的執行階段可見註解 (9ec7cb)

1.1.0 版本

2019 年 12 月 4 日

已釋出 androidx.coordinatorlayout:coordinatorlayout:1.1.0。1.1.0 版包含此連結所列的修訂項目。

自 1.0.0 版以來的重要變更

aosp/737190：CoordinatorLayout 實作了 NestedScrollingParent3，CoordinatorLayout.Behavior 實作了新的 onNestedScroll 多載，以便Behaviors 向巢狀捲動子項報告自己所消耗的捲動距離（在 dispatchNestedScroll()/onNestedScroll() 傳遞期間）。原先的 onNestedScroll(CoordinatorLayout, V, View, int, int, int, int, int) 已淘汰，改用了新的 onNestedScroll(CoordinatorLayout, V, View, int, int, int, int, int, int[])，Behavior 實作也應進行相應的更新。如果目前開發人員程式碼覆寫了 CoordinatorLayout#onNestedScroll(View, int, int, int, int, int)，則可能不會再對其進行呼叫，而應改為覆寫 CoordinatorLayout#onNestedScroll(View, int, int, int, int, int, int[])。
將 CoordinatorLayout 公開至無障礙服務 (aosp/1056175)
CoordinatorLayout.DefaultBehavior 註解已淘汰。請改用 CoordinatorLayout.AttachedBehavior 介面。

1.1.0-rc01 版本

2019 年 10 月 23 日

androidx.coordinatorlayout:coordinatorlayout:1.1.0-rc01 發布。1.1.0-rc01 版包含這些修訂版本。

新功能

將 CoordinatorLayout 公開至無障礙服務 (aosp/1056175)

1.1.0-beta01 版本

2019 年 6 月 5 日

已釋出 androidx.coordinatorlayout:coordinatorlayout:1.1.0-beta01。您可以前往這裡查看這個版本包含的修訂版本。

修正錯誤

遷移已被淘汰的測試類別 (aosp/853955)

1.1.0-alpha01 版本

2018 年 12 月 3 日

API 變更

aosp/737190：CoordinatorLayout 是做了 NestedScrollingParent3，CoordinatorLayout.Behavior實作了新的 onNestedScroll 多載，以便 Behaviors 向巢狀捲動子項報告自己所消耗的捲動距離（在 dispatchNestedScroll()/onNestedScroll() 傳遞期間）。原先的 onNestedScroll(CoordinatorLayout, V, View, int, int, int, int, int) 已淘汰，改用了新的 onNestedScroll(CoordinatorLayout, V, View, int, int, int, int, int, int[])，Behavior 實作也應進行相應的更新。

如果目前開發人員程式碼覆寫了 CoordinatorLayout#onNestedScroll(View, int, int, int, int, int)，則可能不會再對其進行呼叫，而應改為覆寫 CoordinatorLayout#onNestedScroll(View, int, int, int, int, int, int[])。