platform-guideline 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.

Open source

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.

Evidence Role

This source is treated as platform-guideline evidence. Use it to validate the decision rules above, not as a visual style reference.

Publisher: Android Developers. Last checked: .