共计 9965 个字符,预计需要花费 25 分钟才能阅读完成。
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 常识的高峰
正文完