滑動重新整理版面配置

實作滑動重新整理 UI 模式。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2020 年 7 月 22 日 1.1.0 - - 1.2.0-alpha01

宣告依附元件

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

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

Groovy

dependencies {
    implementation "androidx.swiperefreshlayout:swiperefreshlayout:1.1.0"
}

Kotlin

dependencies {
    implementation("androidx.swiperefreshlayout:swiperefreshlayout:1.1.0")
}

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

意見回饋

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

建立新問題

詳情請參閱 Issue Tracker 說明文件

1.2.0 版

1.2.0-alpha01 版

2020 年 7 月 22 日

發布 androidx.swiperefreshlayout:swiperefreshlayout:1.2.0-alpha011.2.0-alpha01 版包含此連結所列的修訂項目。

修正錯誤

  • requestDisallowInterceptTouchEvent(boolean) 現在會遵守要求,就像任何其他 ViewGroup 一樣。雖然我們不鼓勵這樣做,但可以透過 setLegacyRequestDisallowInterceptTouchEventEnabled 停用新的行為。(I968dab/141855018)

1.1.0 版本

1.1.0 版本

2020 年 6 月 24 日

發布 androidx.swiperefreshlayout:swiperefreshlayout:1.1.01.1.0 版本包含以下修訂項目。

自 1.0.0 版起的重大異動

  • SwipeRefreshLayout 現可實作 NestedScrollingChild3NestedScrollingParent3

1.1.0-rc01 版本

2020 年 4 月 15 日

androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-rc011.1.0-beta01起沒有變更。1.1.0-rc01 版本包含以下修訂項目。

1.1.0-beta01 版本

2020 年 3 月 4 日

androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-beta011.1.0-alpha03起沒有變更。1.1.0-beta01 版本包含以下修訂項目。

1.1.0-alpha03 版

2019 年 10 月 9 日

發布了 androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-alpha031.1.0-alpha03 版包含此連結所列的修訂項目

新功能

  • 我們使用新的樣式屬性 R.styleable.SwipeRefreshLayout_swipeRefreshLayoutProgressSpinnerBackgroundColor 來設定進度指標的背景顏色。(aosp/931124)。

API 相關異動

  • requestDisallowInterceptTouchEvent(boolean) 現在一律會向上傳播至其父項。雖然我們不鼓勵這樣做,但可以透過 setLegacyRequestDisallowInterceptTouchEventEnabled 停用新行為。(aosp/1108540)。

修正錯誤

  • 修正問題:SwipeRefreshLayout 含有可捲動的父項 (例如 ViewPager2) 和可捲動的子項。(b/138314213)。

1.1.0-alpha02 版

2019 年 7 月 2 日

發布 androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-alpha02。您可以前往這裡查看這個版本包含的修訂項目。

修正錯誤

  • 實作了 SwipeRefreshLayout 的儲存和還原重新整理狀態
  • 修正 SwipeRefreshLayout 嵌入 RecyclerView 中的可用性錯誤

1.1.0-alpha01 版

2018 年 12 月 3 日

API 相關異動

  • aosp/737631SwipeRefreshLayout 現在會實作 NestedScrollingChild3NestedScrollingParent3,讓巢狀捲動 3 的父項和子項能夠透過 SwipeRefreshLayout 傳遞使用的巢狀捲動距離資訊。如果開發人員程式碼目前覆寫了 SwipeRefreshLayout.onNestedScroll(View, int, int, int, int, int),則可能不會再呼叫,並且應改為覆寫 SwipeRefreshLayout.onNestedScroll(View, int, int, int, int, int, int[])。同樣地,系統也可能不會再呼叫 SwipeRefreshLayout.dispatchNestedScroll(int, int, int, int, int[], int),而是改為覆寫 SwipeRefreshLayout.dispatchNestedScroll(int, int, int, int, int[], int, int[])