Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Swiperefreshlayout
Implémenter le modèle d'interface utilisateur swipe-to-refresh.
Dernière mise à jour |
Version stable |
Version finale |
Version bêta |
Version alpha |
12 février 2025 |
1.1.0 |
- |
1.2.0-beta01 |
- |
Déclarer des dépendances
Pour ajouter une dépendance à SwipeRefreshLayout, vous devez ajouter le dépôt Maven Google à votre projet. Consultez la section Dépôt Maven de Google pour en savoir plus.
Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle
de votre application ou de votre module :
Groovy
dependencies {
implementation "androidx.swiperefreshlayout:swiperefreshlayout:1.1.0"
}
Kotlin
dependencies {
implementation("androidx.swiperefreshlayout:swiperefreshlayout:1.1.0")
}
Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.
Commentaires
Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.
Signaler un nouveau problème
Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.
Version 1.2.0
Version 1.2.0-beta01
12 février 2025
Publication d'androidx.swiperefreshlayout:swiperefreshlayout:1.2.0-beta01
. La version 1.2.0-beta01 contient ces commits.
Modifications apportées à l'API
- Spécification de la possibilité de valeur nulle des paramètres et des types de retour de la méthode
SwipeRefreshLayout
(I006d1, b/236497776)
Correction de bugs
- Cette bibliothèque utilise désormais les annotations de nullité JSpecify, qui sont des annotations de type. Les développeurs Kotlin doivent utiliser l'argument de compilateur suivant pour appliquer une utilisation correcte:
-Xjspecify-annotations=strict
(valeur par défaut à partir de la version 2.1.0 du compilateur Kotlin). (Iaf490, b/326456246)
Version 1.2.0-alpha01
22 juillet 2020
Publication de androidx.swiperefreshlayout:swiperefreshlayout:1.2.0-alpha01
. Liste des commits de la version 1.2.0-alpha01.
Corrections de bugs
requestDisallowInterceptTouchEvent(boolean)
respecte désormais la requête comme tout autre ViewGroup. Bien que cela soit vivement déconseillé, le nouveau comportement peut être désactivé à l'aide de setLegacyRequestDisallowInterceptTouchEventEnabled
. (I968da, b/141855018)
Version 1.1.0
Version 1.1.0
24 juin 2020
Publication d'androidx.swiperefreshlayout:swiperefreshlayout:1.1.0
. Liste des commits de la version 1.1.0
Principales modifications depuis la version 1.0.0
SwipeRefreshLayout
implémente maintenant NestedScrollingChild3
et NestedScrollingParent3
.
Version 1.1.0-rc01
15 avril 2020
Publication de androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-rc01
sans aucune modification par rapport à la version 1.1.0-beta01
. Liste des commits de la version 1.1.0-rc01
Version 1.1.0-beta01
4 mars 2020
Publication de androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-beta01
sans aucune modification par rapport à la version 1.1.0-alpha03
. Liste des commits de la version 1.1.0-beta01
Version 1.1.0-alpha03
9 octobre 2019
Publication de androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-alpha03
. Liste des commits de la version 1.1.0-alpha03
Nouvelles fonctionnalités
- Ajout d'un nouvel attribut de style
R.styleable.SwipeRefreshLayout_swipeRefreshLayoutProgressSpinnerBackgroundColor
pour définir la couleur de l'arrière-plan de l'indicateur de progression. (aosp/931124)
Modifications apportées à l'API
requestDisallowInterceptTouchEvent(boolean)
est désormais toujours propagé jusqu'à ses parents. Bien que cela soit vivement déconseillé, le nouveau comportement peut être désactivé à l'aide de setLegacyRequestDisallowInterceptTouchEventEnabled
. (aosp/1108540)
Corrections de bugs
- Résolution du problème lié au défilement imbriqué lorsque SwipeRefreshLayout comporte un parent déroulant (par exemple, ViewPager2) et un enfant déroulant. (b/138314213)
Version 1.1.0-alpha02
2 juillet 2019
Publication d'androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-alpha02
. Les commits inclus dans cette version sont disponibles sur cette page.
Corrections de bugs
- Mise en œuvre de l'enregistrement et de la restauration de l'état d'actualisation de SwipeRefreshLayout
- Correction d'un bug d'usabilité qui survenait en cas d'intégration de SwipeRefreshLayout dans un RecyclerView
Version 1.1.0-alpha01
3 décembre 2018
Modifications apportées à l'API
- AOSP/737631 :
SwipeRefreshLayout
implémente désormais NestedScrollingChild3
et NestedScrollingParent3
, qui permettent à trois parents et enfants de défilement imbriqué de faire défiler les propriétés de défilement imbriqué via SwipeRefreshLayout
. Si le code de développeur ignore actuellement SwipeRefreshLayout.onNestedScroll(View, int, int, int, int, int)
, il ne sera probablement plus appelé. SwipeRefreshLayout.onNestedScroll(View, int, int, int, int, int, int[])
devra être ignoré à la place. De même, SwipeRefreshLayout.dispatchNestedScroll(int, int, int, int, int[], int)
ne sera probablement plus appelé, et SwipeRefreshLayout.dispatchNestedScroll(int, int, int, int, int[], int, int[])
doit être ignoré à la place.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/27 (UTC)."],[],[],null,["# Swiperefreshlayout\n==================\n\n[Code Sample](https://github.com/android/views-widgets-samples) \nAPI Reference \n[androidx.swiperefreshlayout.widget](/reference/kotlin/androidx/swiperefreshlayout/widget/package-summary) \nImplement the swipe-to-refresh UI pattern. \n\n| Latest Update | Stable Release | Release Candidate | Beta Release | Alpha Release |\n|-------------------|--------------------------------------------------------------|-------------------|----------------------------------------------------------------------------|---------------|\n| February 12, 2025 | [1.1.0](/jetpack/androidx/releases/swiperefreshlayout#1.1.0) | - | [1.2.0-beta01](/jetpack/androidx/releases/swiperefreshlayout#1.2.0-beta01) | - |\n\nDeclaring dependencies\n----------------------\n\nTo add a dependency on SwipeRefreshLayout, you must add the Google Maven repository to your\nproject. Read [Google's Maven repository](/studio/build/dependencies#google-maven)\nfor more information.\n\nAdd the dependencies for the artifacts you need in the `build.gradle` file for\nyour app or module: \n\n### Groovy\n\n```groovy\ndependencies {\n implementation \"androidx.swiperefreshlayout:swiperefreshlayout:1.1.0\"\n}\n```\n\n### Kotlin\n\n```kotlin\ndependencies {\n implementation(\"androidx.swiperefreshlayout:swiperefreshlayout:1.1.0\")\n}\n```\n\nFor more information about dependencies, see [Add build dependencies](/studio/build/dependencies).\n\nFeedback\n--------\n\nYour feedback helps make Jetpack better. Let us know if you discover new issues or have\nideas for improving this library. Please take a look at the\n[existing issues](https://issuetracker.google.com/issues?q=componentid:460836%20status:open)\nin this library before you create a new one. You can add your vote to an existing issue by\nclicking the star button.\n\n[Create a new issue](https://issuetracker.google.com/issues/new?component=460836&template=1422576)\n\nSee the [Issue Tracker documentation](https://developers.google.com/issue-tracker)\nfor more information.\n\nVersion 1.2.0\n-------------\n\n### Version 1.2.0-beta01\n\nFebruary 12, 2025\n\n`androidx.swiperefreshlayout:swiperefreshlayout:1.2.0-beta01` is released. Version 1.2.0-beta01 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/9f60cc700129e30cee9df020005c317fb39d32ec..7344269b2d862d014a647efafcd7735f0d53f1da/swiperefreshlayout/swiperefreshlayout).\n\n**API Changes**\n\n- Specified nullability of `SwipeRefreshLayout` method parameters and return types ([I006d1](https://android-review.googlesource.com/#/q/I006d15100662ca77db65dd0cf4735c65cee84dfd), [b/236497776](https://issuetracker.google.com/issues/236497776))\n\n**Bug Fixes**\n\n- This library now uses [JSpecify nullness annotations](https://jspecify.dev/), which are type-use. Kotlin developers should use the following compiler argument to enforce correct usage: `-Xjspecify-annotations=strict` (this is the default starting with version 2.1.0 of the Kotlin compiler). ([Iaf490](https://android-review.googlesource.com/#/q/Iaf49080833b450a7dbba982367bfd863a2ead6ad), [b/326456246](https://issuetracker.google.com/issues/326456246))\n\n### Version 1.2.0-alpha01\n\nJuly 22, 2020\n\n`androidx.swiperefreshlayout:swiperefreshlayout:1.2.0-alpha01` is released. [Version 1.2.0-alpha01 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/6b97b146b743340c9d9b6fa54e735404374f2a5f..9f60cc700129e30cee9df020005c317fb39d32ec/swiperefreshlayout/swiperefreshlayout)\n\n**Bug Fixes**\n\n- `requestDisallowInterceptTouchEvent(boolean)` now honors the request like any other ViewGroup. While strongly discouraged, new behavior can be disabled with `setLegacyRequestDisallowInterceptTouchEventEnabled`. ([I968da](https://android-review.googlesource.com/#/q/I968da769d8400caf6f52c8a12595ee19fb4c0773), [b/141855018](https://issuetracker.google.com/issues/141855018))\n\nVersion 1.1.0\n-------------\n\n### Version 1.1.0\n\nJune 24, 2020\n\n`androidx.swiperefreshlayout:swiperefreshlayout:1.1.0` is released. [Version 1.1.0 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/6563b7854e79a3f7182efe27ee726867a091b603..6b97b146b743340c9d9b6fa54e735404374f2a5f/swiperefreshlayout/swiperefreshlayout)\n\n**Major changes since 1.0.0**\n\n- `SwipeRefreshLayout` now implements `NestedScrollingChild3` and `NestedScrollingParent3`.\n\n### Version 1.1.0-rc01\n\nApril 15, 2020\n\n`androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-rc01` is released with no changes since `1.1.0-beta01`. [Version 1.1.0-rc01 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/666ae665acfcfa2a20eccc18e4494808169742f4..6563b7854e79a3f7182efe27ee726867a091b603/swiperefreshlayout/swiperefreshlayout)\n\n### Version 1.1.0-beta01\n\nMarch 4, 2020\n\n`androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-beta01` is released with no changes since `1.1.0-alpha03`. [Version 1.1.0-beta01 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/f14ad350142290622d1645e1d0e280cbe8ca4c2f..666ae665acfcfa2a20eccc18e4494808169742f4/swiperefreshlayout/swiperefreshlayout)\n\n### Version 1.1.0-alpha03\n\nOctober 9, 2019\n\n`androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-alpha03` is released. [Version 1.1.0-alpha03 contains these commits](https://android.googlesource.com/platform/frameworks/support/+log/9a7b3cb32a2c7adac9b7af4bc2f996f1eb79fc12..f14ad350142290622d1645e1d0e280cbe8ca4c2f/swiperefreshlayout).\n\n**New features**\n\n- We have a new style attribute `R.styleable.SwipeRefreshLayout_swipeRefreshLayoutProgressSpinnerBackgroundColor`to set the background color of the progress indicator. ([aosp/931124](https://android-review.googlesource.com/931124))\n\n**API changes**\n\n- `requestDisallowInterceptTouchEvent(boolean)` now always propagates up to its parents. While strongly discouraged, new behavior can be disabled with `setLegacyRequestDisallowInterceptTouchEventEnabled`. ([aosp/1108540](https://android-review.googlesource.com/1108540))\n\n**Bug fixes**\n\n- Fixed issue with nested scrolling where SwipeRefreshLayout has a scrollable parent (e.g. [ViewPager2](/jetpack/androidx/releases/viewpager2)) and a scrollable child. ([b/138314213](https://issuetracker.google.com/issues/138314213))\n\n### Version 1.1.0-alpha02\n\nJuly 2, 2019\n\n`androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-alpha02` is released. The commits included in this version can be found [here](https://android.googlesource.com/platform/frameworks/support/+log/d9ca300b3f70db75744a6d743f85e3784287434a..9a7b3cb32a2c7adac9b7af4bc2f996f1eb79fc12/swiperefreshlayout).\n| **Note:** This version is dependent on the Java 8 programming language. Please read [Use Java 8 language features](/studio/write/java8-support) to learn how to use it in your project.\n\n**Bug fixes**\n\n- Implemented saving and restoring of the refreshing state of SwipeRefreshLayout\n- Fixed usability bug when SwipeRefreshLayout is embedded in a RecyclerView\n\n### Version 1.1.0-alpha01\n\nDecember 3, 2018\n\n**API changes**\n\n- [aosp/737631](): `SwipeRefreshLayout` now implements `NestedScrollingChild3` and `NestedScrollingParent3`, enabling nested scrolling 3 parents and children to pass consumed nested scrolling distance information through `SwipeRefreshLayout`. If developer code currently overrides `SwipeRefreshLayout.onNestedScroll(View, int, int, int, int, int)`, it will likely no longer be called and `SwipeRefreshLayout.onNestedScroll(View, int, int, int, int, int, int[])` should be overridden instead. Likewise, `SwipeRefreshLayout.dispatchNestedScroll(int, int, int, int, int[], int)` will likely no longer be called and `SwipeRefreshLayout.dispatchNestedScroll(int, int, int, int, int[], int, int[])` should be overridden instead."]]