platform-guideline 1 linked patterns checked
Android Developers: Add swipe-to-refresh to your app
Documents SwipeRefreshLayout for adding a swipe-to-refresh widget around scrollable content and explicitly recommends an action-bar refresh item so users who cannot perform the gesture can still trigger the same update.
Read with a purpose
What this source can teach
Use this source to understand a platform convention and the setting it was designed for.
- Start with the original. Open the source and find the guidance or example relevant to your task.
- Trace the connection. Use the claim notes below to see how this site applies the source to specific patterns.
- Check the setting. Compare the source's platform, people, and constraints with your own decision.
Pattern Decisions This Source Supports
| Pattern | Supported decision | Required contract | Claim note |
|---|---|---|---|
| Pull to refresh | Choose pull to refresh when the design problem is the vertical top-of-scroll drag that refreshes the current data set. | Pull-to-refresh begins only when the intended scroll container is at its top boundary and the user drags downward beyond normal scroll tolerance. | Supports using swipe-to-refresh with scrollable content and providing a manual refresh menu action for users who cannot perform the gesture. |
Comparisons supported by this source
- Pull to refresh vs touch gesture vs feed vs offline state vs loading spinner vs retry
Supports scrollable swipe-to-refresh and the accessible manual refresh action.
Evidence Role
This source is treated as platform-guideline evidence. Its value comes from the specific claims and setting described above.
Publisher: Android Developers. Last checked: .