1page.title=Supporting Swipe-to-Refresh
2trainingnavtop=true
3startpage=true
4
5
6@jd:body
7
8<div id="tb-wrapper">
9<div id="tb">
10
11<h2>Dependencies and prerequisites</h2>
12<ul>
13  <li>Android 1.6 (API level 4) or later
14  </li>
15
16  <li>Latest version of the Android v4 <a href=
17  "{@docRoot}tools/support-library/index.html">Support Library</a>
18  </li>
19</ul>
20
21<h2>Sample Apps</h2>
22
23<ul>
24    <li><a href="{@docRoot}samples/SwipeRefreshLayoutBasic/index.html">
25            SwipeRefreshLayoutBasic</a></li>
26    <li><a href="{@docRoot}samples/SwipeRefreshListFragment/index.html">
27            SwipeRefreshListFragment</a></li>
28    <li><a href="{@docRoot}samples/SwipeRefreshMultipleViews/index.html">
29            SwipeRefreshMultipleViews</a></li>
30</ul>
31
32</div>
33</div>
34
35<p>
36  Even if your app automatically updates its content on a regular basis, you
37  can allow users to request manual updates as well. For example, a weather
38  forecasting app can allow users get the latest forecasts on demand. To
39  provide a standard user experience for requesting updates, the Android
40  platform includes the swipe-to-refresh design pattern, which allows users
41  to trigger an update with a vertical swipe.
42</p>
43
44<p class="note">
45  <strong>Note:</strong> This class requires the latest version of the Android
46  v4 Support Library APIs. If you have not used the Support Library before,
47  follow the instructions in the <a href=
48  "{@docRoot}tools/support-library/setup.html">Support Library Setup</a>
49  document.
50</p>
51
52<h2>Lessons</h2>
53
54<dl>
55  <dt>
56    <b><a href="add-swipe-interface.html">Adding Swipe-to-Refresh To Your
57    App</a></b>
58  </dt>
59
60  <dd>
61    <div style="width:290px;margin-right:35px;float:right">
62      <div class="framed-nexus5-port-span-5">
63        <video class="play-on-hover" autoplay alt=
64        "When the user performs a swipe gesture, the SwipeRefreshLayout widget displays a progress indicator until your app finishes updating its data.">
65        <!-- Preferred video size 216x384 (portrait) -->
66          <source src="images/swipe.mp4">
67        </video>
68      </div>
69
70      <div style="font-size:10pt;margin-left:20px;margin-bottom:30px">
71        <em>To replay the movie, click on the device screen</em>
72      </div>
73    </div>
74  </dd>
75
76  <dd>
77    Learn how to provide swipe-to-refresh support in a {@link
78    android.widget.ListView} or {@link android.widget.GridView}, and how to
79    provide an accessible refresh option using the action bar.
80  </dd>
81
82  <dt>
83    <b><a href="respond-refresh-request.html">Responding to a Refresh
84    Request</a></b>
85  </dt>
86
87  <dd>
88    Learn how to respond to the swipe-to-refresh gesture, and how to perform the
89    same update from an action bar action.
90  </dd>
91</dl>
92