Swiperefreshlayout

宣告依附元件

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

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

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

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

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

意見回饋

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

建立新問題

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

1.2.0 版本

1.2.0-beta01 版本

2025 年 2 月 12 日

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

API 變更

• 指定 SwipeRefreshLayout 方法參數和傳回類型的可為空值性 (I006d1、b/236497776)

修正錯誤

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

1.2.0-alpha01 版本

2020 年 7 月 22 日

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

修正錯誤

• requestDisallowInterceptTouchEvent(boolean) 現在會回應要求，與其他 ViewGroup 一樣。雖然我們不鼓勵這樣做，但可以透過 setLegacyRequestDisallowInterceptTouchEventEnabled 停用新的行為。(I968da、b/141855018)。

1.1.0 版本

1.1.0 版本

2020 年 6 月 24 日

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

自 1.0.0 版起的重大異動

• SwipeRefreshLayout 現已實作 NestedScrollingChild3 和 NestedScrollingParent3。

1.1.0-rc01 版本

2020 年 4 月 15 日

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

1.1.0-beta01 版本

2020 年 3 月 4 日

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

1.1.0-alpha03 版本

2019 年 10 月 9 日

發布了 androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-alpha03。1.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 的重新整理狀態
• 修正在 RecyclerView 中嵌入 SwipeRefreshLayout 時的可用性錯誤

1.1.0-alpha01 版本

2018 年 12 月 3 日

API 變更

• aosp/737631：SwipeRefreshLayout 現在實作 NestedScrollingChild3 和 NestedScrollingParent3，巢狀結構捲動的 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[])。