1. 導(dǎo)入庫(kù)
clone：https://github.com/chrisbanes/Android-PullToRefresh.git
可以把 library 文件夾重命名為 PullToRefresh。
Android Studio 中 File => New => Import Module损趋，導(dǎo)入 PullToRefresh 文件夾度液。
dependencies {
......
compile project(':pullToRefresh')
}
還要把自己工程和 PullToRefresh 的 build.gradle 文件里的版本統(tǒng)一：
android {
compileSdkVersion 24
buildToolsVersion "23.0.2"
defaultConfig {
minSdkVersion 15
targetSdkVersion 24
}
Rubuild 后就能用了巨朦。
2. 簡(jiǎn)單使用
<!--The PullToRefreshListView replaces a standard ListView widget.
The ID CAN NOT be @+id/android:list-->
<com.handmark.pulltorefresh.library.PullToRefreshListView
android:id="@+id/pull_to_refresh_listview"
android:layout_height="fill_parent"
android:layout_width="fill_parent" />
// Set a listener to be invoked when the list should be refreshed.
PullToRefreshListView pullToRefreshView = (PullToRefreshListView) findViewById(R.id.pull_to_refresh_listview);
pullToRefreshView.setOnRefreshListener(new OnRefreshListener<ListView>() {
@Override
public void onRefresh(PullToRefreshBase<ListView> refreshView) {
// Do work to refresh the list here.
new GetDataTask().execute();
}
});
private class GetDataTask extends AsyncTask<Void, Void, String[]> {
...
@Override
protected void onPostExecute(String[] result) {
// Call onRefreshComplete when the list has been refreshed.
pullToRefreshView.onRefreshComplete();
super.onPostExecute(result);
}
}
- 得到 View 的實(shí)例：
getRefreshableView()
3. 自定義 PullToRefresh View
PullToRefresh 只支持以下 View：
ListView
ExpandableListView
GridView
WebView
ScrollView
HorizontalScrollView
ViewPager
如 RecyclerView出吹、NestedScrollView 等跌榔，可以自己封裝一個(gè)。
1. 新建類繼承 PullToRefreshBase
2. 復(fù)寫(xiě)幾個(gè)構(gòu)造方法
3. 復(fù)寫(xiě)四個(gè)重要抽象方法
public class PullToRefreshNestedScrollView extends PullToRefreshBase<NestedScrollView> {
public PullToRefreshNestedScrollView(Context context) {
super(context);
}
public PullToRefreshNestedScrollView(Context context, AttributeSet attrs) {
super(context, attrs);
}
public PullToRefreshNestedScrollView(Context context, Mode mode) {
super(context, mode);
}
public PullToRefreshNestedScrollView(Context context, Mode mode, AnimationStyle animStyle) {
super(context, mode, animStyle);
}
// 滑動(dòng)方向
// Orientation.VERTICAL、Orientation.HORIZONTAL
@Override
public Orientation getPullToRefreshScrollDirection() {
return Orientation.VERTICAL;
}
// 滑動(dòng)的 View
// 創(chuàng)建一個(gè)想應(yīng)用于的 View 的實(shí)例就行
@Override
protected NestedScrollView createRefreshableView(Context context, AttributeSet attrs) {
return new MyNestedScrollView(context, attrs);
}
// 判斷是否滑動(dòng)到底部了测蹲，返回 true 就會(huì)執(zhí)行上拉加載
@Override
protected boolean isReadyForPullEnd() {
// 寫(xiě)判斷邏輯
return false;
}
// 判斷是否滑動(dòng)到頂部了，返回 true 就會(huì)執(zhí)行下拉刷新
@Override
protected boolean isReadyForPullStart() {
// 寫(xiě)判斷邏輯
return false;
}
}
4. 自定義屬性
res/values/attrs.xml 中：
<?xml version="1.0" encoding="utf-8"?>
<resources>
<declare-styleable name="PullToRefresh">
<!-- 設(shè)置刷新列表的背景色 -->
<attr name="ptrRefreshableViewBackground" format="reference|color" />
<!-- 設(shè)置下拉Header或者上拉Footer的背景色 -->
<attr name="ptrHeaderBackground" format="reference|color" />
<!-- 用于設(shè)置Header與Footer中文本的顏色 -->
<attr name="ptrHeaderTextColor" format="reference|color" />
<!-- 用于設(shè)置Header與Footer中上次刷新時(shí)間文本的顏色 -->
<attr name="ptrHeaderSubTextColor" format="reference|color" />
<!-- 刷新模式 -->
<attr name="ptrMode">
<flag name="disabled" value="0x0" /> <!-- 禁用下拉刷新 -->
<flag name="pullFromStart" value="0x1" /> <!-- 僅支持下拉刷新 -->
<flag name="pullFromEnd" value="0x2" /> <!-- 僅支持上拉刷新 -->
<flag name="both" value="0x3" /> <!-- 上拉刷新和下拉刷新都支持 -->
<flag name="manualOnly" value="0x4" /> <!-- 只允許手動(dòng)觸發(fā) -->
<!-- These last two are depreacted -->
<flag name="pullDownFromTop" value="0x1" />
<flag name="pullUpFromBottom" value="0x2" />
</attr>
<!-- 如果為true會(huì)在mPullRefreshListView中出現(xiàn)icon鬼吵，右上角和右下角扣甲，挺有意思的 -->
<attr name="ptrShowIndicator" format="reference|boolean" />
<!-- 同時(shí)改變頭部和底部的刷新圖標(biāo) -->
<attr name="ptrDrawable" format="reference" />
<!-- 頭部視圖的刷新圖標(biāo) -->
<attr name="ptrDrawableStart" format="reference" />
<!-- 底部視圖的刷新圖標(biāo) -->
<attr name="ptrDrawableEnd" format="reference" />
<attr name="ptrOverScroll" format="reference|boolean" />
<!-- 分別設(shè)置拉Header或者上拉Footer中字體的類型顏色等等 -->
<attr name="ptrHeaderTextAppearance" format="reference" />
<attr name="ptrSubHeaderTextAppearance" format="reference" />
<!-- flip（翻轉(zhuǎn)動(dòng)畫(huà)）， rotate（旋轉(zhuǎn)動(dòng)畫(huà)） -->
<attr name="ptrAnimationStyle">
<flag name="rotate" value="0x0" />
<flag name="flip" value="0x1" />
</attr>
<!-- 刷新的時(shí)候齿椅，是否允許ListView或GridView滾動(dòng) -->
<attr name="ptrScrollingWhileRefreshingEnabled" format="reference|boolean" />
<!-- 決定了Header琉挖，F(xiàn)ooter以何種方式加入mPullRefreshListView，true為headView方式加入涣脚，就是滾動(dòng)時(shí)刷新頭部會(huì)一起滾動(dòng),false不能刷新 -->
<attr name="ptrListViewExtrasEnabled" format="reference|boolean" />
<!-- 拉的時(shí)候頭部或者尾部的刷新圖片示辈，是否多次旋轉(zhuǎn)，true多次遣蚀，false只是旋轉(zhuǎn)一周矾麻，在下拉，圖片不會(huì)在跟著旋轉(zhuǎn) -->
<attr name="ptrRotateDrawableWhilePulling" format="reference|boolean" />
<!-- BELOW HERE ARE DEPRECEATED. DO NOT USE. -->
<attr name="ptrAdapterViewBackground" format="reference|color" />
<attr name="ptrDrawableTop" format="reference" />
<attr name="ptrDrawableBottom" format="reference" />
</declare-styleable>
</resources>
使用方法：
- 在布局文件頭部加入
xmlns:ptr="http://schemas.android.com/apk/res-auto" - 在 PullToRefreshView 節(jié)點(diǎn)使用
ptr:ptrMode="both"等進(jìn)行設(shè)置芭梯。
