Android 智能刷新框架SmartRefreshLayout
SmartRefreshLayout是一个“聪明”或者“智能”的下拉刷新布局，由于它的“智能”，它不只是支持所有的View，还支持多层嵌套的视图结构。它继承自ViewGroup 而不是FrameLayout或LinearLayout，提高了性能。
添加依赖
implementation 'com.scwang.smart:refresh-layout-kernel:2.0.3' //核心必须依赖
implementation 'com.scwang.smart:refresh-header-classics:2.0.3'//经典刷新头
implementation 'com.scwang.smart:refresh-footer-classics:2.0.3' //经典加载
一：基本使用
1.布局文件
<com.scwang.smart.refresh.layout.SmartRefreshLayout
android:id="@+id/refreshLayout"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="#444444"
app:srlAccentColor="@android:color/white"
app:srlEnablePreviewInEditMode="true"
app:srlPrimaryColor="#444444">
<com.scwang.smart.refresh.header.ClassicsHeader
android:layout_width="match_parent"
android:layout_height="wrap_content"/>
<androidx.recyclerview.widget.RecyclerView
android:id="@+id/recycler"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="#fff"
android:overScrollMode="never"/>
<com.scwang.smart.refresh.footer.ClassicsFooter
android:layout_width="match_parent"
android:layout_height="wrap_content"/>
</com.scwang.smart.refresh.layout.SmartRefreshLayout>代码:
public class ThirdActivity extends AppCompatActivity {
private SmartRefreshLayout smartRefreshLayout;
private RecyclerView recyclerView;
private MyAdatpter myAdatpter;
private List<String> datas=new ArrayList<>();
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_third);
initData();
smartRefreshLayout= findViewById(R.id.refreshLayout);
//smartRefreshLayout.autoLoadMore();//自动加载
//smartRefreshLayout.autoRefresh();//自动刷新
smartRefreshLayout.setEnableAutoLoadMore(true);//是否启用列表惯性滑动到底部时自动加载更多
smartRefreshLayout.setEnableLoadMore(true);//是否启用加载更多功能
smartRefreshLayout.setEnableRefresh(true);//是否启用下拉刷新功能
recyclerView=findViewById(R.id.recycler);
LinearLayoutManager layoutManager=new LinearLayoutManager(this,LinearLayoutManager.VERTICAL,false);
recyclerView.setLayoutManager(layoutManager);
myAdatpter=new MyAdatpter(this,datas);
recyclerView.setAdapter(myAdatpter);
smartRefreshLayout.setOnRefreshListener(new OnRefreshListener() {
@Override
public void onRefresh(@NonNull RefreshLayout refreshLayout) {
Toast.makeText(ThirdActivity.this,"我请求下拉刷新数据",Toast.LENGTH_LONG).show();
refreshLayout.finishRefresh();//下拉刷新结束
//refreshLayout.finishRefresh(2000);//2s结束
}
});
smartRefreshLayout.setOnLoadMoreListener(new OnLoadMoreListener() {
@Override
public void onLoadMore(@NonNull RefreshLayout refreshLayout) {
Toast.makeText(ThirdActivity.this, "我请求加载更多数据", Toast.LENGTH_SHORT).show();
refreshLayout.finishLoadMore();
}
});
}
private void initData() {
for (int i=0;i<40;i++){
datas.add("我是测试数据"+i);
}
}
}里面的MyAdapter是recyclerView的数据适配器适配测试数据的
public class MyAdatpter extends RecyclerView.Adapter<MyAdatpter.MyViewHolder> {
private Context context;
private List<String> mDatas;
private View view;
//构造方法，传入数据
public MyAdatpter(Context context,List<String> mDatas) {
this.context=context;
this.mDatas=mDatas;
}
@NonNull
@Override
public MyViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
//创建ViewHolder ,返回每一项的布局,把view布局转成ViewHolder
view=LayoutInflater.from(context).inflate(R.layout.item_first,parent,false);
return new MyViewHolder(view);
}
@Override
public void onBindViewHolder(@NonNull MyViewHolder holder, int position) {
//绑定布局可控件
holder.item.setText(mDatas.get(position));
}
@Override
public int getItemCount() {
return mDatas.size();
}
static class MyViewHolder extends RecyclerView.ViewHolder{
TextView item;
public MyViewHolder(@NonNull View itemView) {
super(itemView);
item=itemView.findViewById(R.id.item_tv);
}
}
}基本使用可以实现下拉刷新，下拉加载更多功能
二：下拉刷新和上拉加载的一些设置
//下面示例中的值等于默认值
ClassicsHeader header = (ClassicsHeader)findViewById(R.id.header);
header.setAccentColor(android.R.color.white);//设置强调颜色
header.setPrimaryColor(R.color.colorPrimary);//设置主题颜色
header.setTextSizeTitle(16);//设置标题文字大小（sp单位）
header.setTextSizeTitle(16, TypedValue.COMPLEX_UNIT_SP);//同上（1.1.0版本删除）
header.setTextSizeTime(10);//设置时间文字大小（sp单位）
header.setTextSizeTime(10, TypedValue.COMPLEX_UNIT_SP);//同上（1.1.0版本删除）
header.setTextTimeMarginTop(10);//设置时间文字的上边距（dp单位）
header.setTextTimeMarginTopPx(10);//同上-像素单位（1.1.0版本删除）
header.setEnableLastTime(true);//是否显示时间
header.setFinishDuration(500);//设置刷新完成显示的停留时间（设为0可以关闭停留功能）
header.setDrawableSize(20);//同时设置箭头和图片的大小（dp单位）
header.setDrawableArrowSize(20);//设置箭头的大小（dp单位）
header.setDrawableProgressSize(20);//设置图片的大小（dp单位）
header.setDrawableMarginRight(20);//设置图片和箭头和文字的间距（dp单位）
header.setDrawableSizePx(20);//同上-像素单位
header.setDrawableArrowSizePx(20);//同上-像素单位（1.1.0版本删除）
header.setDrawableProgressSizePx(20);//同上-像素单位（1.1.0版本删除）
header.setDrawableMarginRightPx(20);//同上-像素单位（1.1.0版本删除）
header.setArrowBitmap(bitmap);//设置箭头位图（1.1.0版本删除）
header.setArrowDrawable(drawable);//设置箭头图片
header.setArrowResource(R.drawable.ic_arrow);//设置箭头资源
header.setProgressBitmap(bitmap);//设置图片位图（1.1.0版本删除）
header.setProgressDrawable(drawable);//设置图片
header.setProgressResource(R.drawable.ic_progress);//设置图片资源
header.setTimeFormat(new DynamicTimeFormat("上次更新 %s"));//设置时间格式化（时间会自动更新）
header.setLastUpdateText("上次更新 3秒前");//手动更新时间文字设置（将不会自动更新时间）
header.setSpinnerStyle(SpinnerStyle.Translate);//设置移动样式（不支持：MatchLayout）
可代码实现，也同样可以Xml布局设置属性
<com.scwang.smart.refresh.header.ClassicsHeader
android:id="@+id/header"
app:srlTextSizeTitle="10dp"//设置title的文本大小
app:srlTextSizeTime="10dp"//设置时间的文本大小
android:layout_width="match_parent"
android:layout_height="wrap_content"/>加载更多同理也是这样
三：智能SmartRefreshLayout可以设置更多样式的智能加载头
SmartRefreshLayout smartRefreshLayout= findViewById(R.id.refreshLayout);//拿到布局
//设置 Header 为 气球快递 样式
smartRefreshLayout.setRefreshHeader(DeliveryHeader(this))
//设置 Header 为 掉落盒子 样式
smartRefreshLayout.setRefreshHeader(DropBoxHeader(this))
//官方 样式
smartRefreshLayout.setRefreshHeader(MaterialHeader(this))
//苹果水滴 样式
smartRefreshLayout.setRefreshHeader(WaterDropHeader(this))
//经典样式
smartRefreshLayout.setRefreshHeader(ClassicsHeader(this))
//弹出文字 样式
smartRefreshLayout.setRefreshHeader(StoreHouseHeader(this))
//弹出圆圈 样式
smartRefreshLayout.setRefreshHeader(BezierCircleHeader(this))
//贝塞尔雷达 样式 ，setEnableHorizontalDrag设置启用水平拖动
smartRefreshLayout.setRefreshHeader(BezierRadarHeader(this))
//弹出水滴 样式 ，水滴需要一半屏幕高度，慎用
smartRefreshLayout.setRefreshHeader(WaveSwipeHeader(this))
//淘宝二楼 样式
smartRefreshLayout.setRefreshHeader(TwoLevelHeader(this))
//坦克游戏 样式
smartRefreshLayout.setRefreshHeader(FunGameBattleCityHeader(this))
//打砖块游戏 样式
smartRefreshLayout.setRefreshHeader(FunGameHitBlockHeader(this))
//金色校园 样式
smartRefreshLayout.setRefreshHeader(PhoenixHeader(this))
//冲上云霄 样式
smartRefreshLayout.setRefreshHeader(TaurusHeader(this))
其他方法
RefreshLayout refreshLayout = (RefreshLayout)findViewById(R.id.refreshLayout);
refreshLayout.setPrimaryColorsId(R.color.colorPrimary, android.R.color.white);
refreshLayout.setDragRate(0.5f);//显示下拉高度/手指真实下拉高度=阻尼效果
refreshLayout.setReboundDuration(300);//回弹动画时长（毫秒）
refreshLayout.setHeaderHeight(100);//Header标准高度（显示下拉高度>=标准高度 触发刷新）
refreshLayout.setHeaderHeightPx(100);//同上-像素为单位 （V1.1.0删除）
refreshLayout.setFooterHeight(100);//Footer标准高度（显示上拉高度>=标准高度 触发加载）
refreshLayout.setFooterHeightPx(100);//同上-像素为单位 （V1.1.0删除）
refreshLayout.setFooterHeaderInsetStart(0);//设置 Header 起始位置偏移量 1.0.5
refreshLayout.setFooterHeaderInsetStartPx(0);//同上-像素为单位 1.0.5 （V1.1.0删除）
refreshLayout.setFooterFooterInsetStart(0);//设置 Footer 起始位置偏移量 1.0.5
refreshLayout.setFooterFooterInsetStartPx(0);//同上-像素为单位 1.0.5 （V1.1.0删除）
refreshLayout.setHeaderMaxDragRate(2);//最大显示下拉高度/Header标准高度
refreshLayout.setFooterMaxDragRate(2);//最大显示下拉高度/Footer标准高度
refreshLayout.setHeaderTriggerRate(1);//触发刷新距离 与 HeaderHeight 的比率1.0.4
refreshLayout.setFooterTriggerRate(1);//触发加载距离 与 FooterHeight 的比率1.0.4
refreshLayout.setEnableRefresh(true);//是否启用下拉刷新功能
refreshLayout.setEnableLoadMore(false);//是否启用上拉加载功能
refreshLayout.setEnableAutoLoadMore(true);//是否启用列表惯性滑动到底部时自动加载更多
refreshLayout.setEnablePureScrollMode(false);//是否启用纯滚动模式
refreshLayout.setEnableNestedScroll(false);//是否启用嵌套滚动
refreshLayout.setEnableOverScrollBounce(true);//是否启用越界回弹
refreshLayout.setEnableScrollContentWhenLoaded(true);//是否在加载完成时滚动列表显示新的内容
refreshLayout.setEnableHeaderTranslationContent(true);//是否下拉Header的时候向下平移列表或者内容
refreshLayout.setEnableFooterTranslationContent(true);//是否上拉Footer的时候向上平移列表或者内容
refreshLayout.setEnableLoadMoreWhenContentNotFull(true);//是否在列表不满一页时候开启上拉加载功能
refreshLayout.setEnableFooterFollowWhenLoadFinished(false);//是否在全部加载结束之后Footer跟随内容1.0.4
refreshLayout.setEnableOverScrollDrag(false);//是否启用越界拖动（仿苹果效果）1.0.4
refreshLayout.setEnableScrollContentWhenRefreshed(true);//是否在刷新完成时滚动列表显示新的内容 1.0.5
refreshLayout.srlEnableClipHeaderWhenFixedBehind(true);//是否剪裁Header当时样式为FixedBehind时1.0.5
refreshLayout.srlEnableClipFooterWhenFixedBehind(true);//是否剪裁Footer当时样式为FixedBehind时1.0.5
refreshLayout.setDisableContentWhenRefresh(false);//是否在刷新的时候禁止列表的操作
refreshLayout.setDisableContentWhenLoading(false);//是否在加载的时候禁止列表的操作
refreshLayout.setOnMultiPurposeListener(new SimpleMultiPurposeListener());//设置多功能监听器
refreshLayout.setScrollBoundaryDecider(new ScrollBoundaryDecider());//设置滚动边界判断
refreshLayout.setScrollBoundaryDecider(new ScrollBoundaryDeciderAdapter());//自定义滚动边界
refreshLayout.setRefreshHeader(new ClassicsHeader(context));//设置Header
refreshLayout.setRefreshFooter(new ClassicsFooter(context));//设置Footer
refreshLayout.setRefreshContent(new View(context));//设置刷新Content（用于非xml布局代替addView）1.0.4
refreshLayout.autoRefresh();//自动刷新
refreshLayout.autoLoadMore();//自动加载
refreshLayout.autoRefreshAnimationOnly();//自动刷新，只显示动画不执行刷新
refreshLayout.autoLoadMoreAnimationOnly();//自动加载，只显示动画不执行加载
refreshLayout.autoRefresh(400);//延迟400毫秒后自动刷新
refreshLayout.autoLoadMore(400);//延迟400毫秒后自动加载
refreshLayout.finishRefresh();//结束刷新
refreshLayout.finishLoadMore();//结束加载
refreshLayout.finishRefresh(3000);//延迟3000毫秒后结束刷新
refreshLayout.finishLoadMore(3000);//延迟3000毫秒后结束加载
refreshLayout.finishRefresh(false);//结束刷新（刷新失败）
refreshLayout.finishLoadMore(false);//结束加载（加载失败）
refreshLayout.finishLoadMoreWithNoMoreData();//完成加载并标记没有更多数据 1.0.4
refreshLayout.closeHeaderOrFooter();//关闭正在打开状态的 Header 或者 Footer（1.1.0）
refreshLayout.resetNoMoreData();//恢复没有更多数据的原始状态 1.0.4（1.1.0删除）
refreshLayout.setNoMoreData(false);//恢复没有更多数据的原始状态 1.0.5第三方的框架需要我们去研究其实现逻辑，只是会用不能满足需求
END:怎么才能攀登上Android知识的顶峰
android
java
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用。你还可以使用@来通知其他用户。