继续浏览精彩内容
慕课网APP
程序员的梦工厂
打开
继续
感谢您的支持,我会继续努力的
赞赏金额会直接到老师账户
将二维码发送给自己后长按识别
微信支付
支付宝支付

用RecyclerView展示错误和空白界面 附加详情界面实践-MultiItem进阶

桃花长相依
关注TA
已关注
手记 113
粉丝 15
获赞 56

前言

本文是MultiItem系列的进阶文章,讲解如何展示空白、错误等状态页,这个功能比较常用,实现的思路也有很多,本文的思路是把状态页当成一个填充满RecyclerViewItem,不需要事先定义到布局中,然后利用库中封装的一个状态页辅助类进行管理,方便简洁,并且做到了用时再去初始化,减少资源浪费。另外会附加讲一下,对于展示业务中详情页的实践,由于这个实践目前比较简单,所以就不单拿出来写一篇文章了。MultiItem特点:

  • 直接使用业务中的实体类为RecyclerView Adapter设置数据源,不需要做任何封装

  • RecyclerView Adapter零编码,解放了复杂的Adapter

  • 支持DataBinding,让你清爽的编写列表代码

  • 支持Form表单录入,懒加载易复用,支持DataBinding、隐藏域、输入内容验证及是否变化

  • 支持业务详情页展示

  • 支持空白、错误等状态页的展示

源码地址

Github地址:https://github.com/free46000/MultiItem,请大家多多关注。

系列文章

  • [MultiItem用法与详解-优雅的实现多类型]

  • [MultiItem进阶 实现Head Foot和加载更多]

  • [MultiItem进阶 使用DataBinding让RecyclerView代码更简洁清爽]

  • [MultiItem进阶 让我们用RecyclerView实现录入Form表单 给你一个新思路]

  • [MultiItem扩展 仿任务面板 跨多个RecyclerView的Item拖动 支持缩小后拖动]

用法

开启数据绑定

由于用到了数据绑定的技术,首先需要在build.gradle开启DataBinding

dataBinding {
    enabled = true}

状态页使用方法

状态页就是空白错误等页面,首先初始化列表和辅助类,为列表设置点击监听,处理状态页的展示。让每个状态对应一个实例,使用起来更清晰。

protected void initViews() {    //初始化adapter
    BaseItemAdapter adapter = new BaseItemAdapter();    //为XXBean数据源注册XXManager管理类
    adapter.register(TextBean.class, new TextViewManager());
    recyclerView.setAdapter(adapter);
    adapter.addDataItem(new TextBean("展示空白页"));
    adapter.addDataItem(new TextBean("展示错误页"));    //设置点击监听,再点击Item的时候展示空白或者错误页面
    setOnItemClickListener(adapter);    //初始化空白页辅助类
    emptyViewHelper = newStateViewHelper("列表数据为空");    //初始化错误页辅助类
    errorViewHelper = newStateViewHelper("数据加载错误");
}/**
 * 创建新的状态页辅助类
 *
 * @param message 状态页展示的信息
 * @return StateViewHelper
 */private StateViewHelper newStateViewHelper(String message) {    //初始化状态Item
    BaseItemState stateItem = new ItemEmptyAndError(message);    //初始化辅助类,需要一个BaseItemState
    StateViewHelper stateViewHelper = new StateViewHelper(recyclerView, stateItem);    //设置状态页按钮的点击事件监听,处理状态页隐藏
    stateItem.setOnStateClickListener(() -> errorViewHelper.hide());    return stateViewHelper;
}/**
 * 设置点击监听,再点击Item的时候展示空白或者错误页面
 */private void setOnItemClickListener(BaseItemAdapter adapter) {
    adapter.setOnItemClickListener(new OnItemClickListener() {        @Override
        public void onItemClick(BaseViewHolder viewHolder) {            switch (viewHolder.getItemPosition()) {                case 0:                    //展示空白页
                    emptyViewHelper.show();                    break;                case 1:                    //展示错误页
                    errorViewHelper.show();                    break;
            }
        }
    });
}

由上面代码可以看出我们需要一个BaseItemState的类,Demo中自定义了一个ItemEmptyAndError的子类,使用了DataBinding的技术,由于本身并没有承载太多的业务,只是对一些属性进行存储,逻辑基本都在xml布局中,下面我们看下布局的主要代码:

<?xml version="1.0" encoding="utf-8"?><layout ... >

    <data>
        <variable
            name="itemData"
            type="com.freelib.multiitem.demo.state.ItemEmptyAndError"/>
    </data>

    <android.support.constraint.ConstraintLayout ... >

        <TextView
            //文本绑定            android:text="@{itemData.message}"
            ... />

        <Button
            //点击监听            android:onClick="@{() -> itemData.onStateClickListener.onStateClick()}"
            //文本绑定            android:text="@{itemData.btnText}"
            ... />
    </android.support.constraint.ConstraintLayout></layout>

详情页相关实践

Demo中介绍了展示用户详情页,并没有复杂的界面,首先我们为每一条用户信息项声明一个ItemInfo实体,Demo里为了简单,只实现了这一种类型,大家使用的时候视具体业务而定(例如:文章详情功能:就需要,标题、内容、回复等至少三种Item...)。 
下面我们来看看相关实现代码,组装用户展示项,并添加到列表中:

protected void initViews() {
    UserBean userBean = getUserBean();

    recyclerView.setLayoutManager(new LinearLayoutManager(this));    //初始化adapter
    BaseItemAdapter adapter = new BaseItemAdapter();    //为UserBean数据源注册数据绑定View Holder Manager管理类
    adapter.register(ItemInfo.class, new DataBindViewHolderManager<>(
            R.layout.item_info, BR.itemData));
    recyclerView.setAdapter(adapter);    //构建用户信息需要展示的ItemInfo的集合,每个ItemInfo代表页面中的一行
    List<ItemInfo> list = new ArrayList<>(5);
    list.add(new ItemInfo("名字", userBean.getName()));
    list.add(new ItemInfo("性别", userBean.getSex()));
    list.add(new ItemInfo("年龄", userBean.getAge()));
    list.add(new ItemInfo("城市", userBean.getAddr()));
    list.add(new ItemInfo("介绍", userBean.getInfo()));
    adapter.setDataItems(list);
}

然后我们看下ItemInfo实体类,其实非常简单:

public class ItemInfo {    private String name;    private String value;    public ItemInfo(String name, String value) {        this.name = name;        this.value = value;
    }    public String getName() {        return name;
    }    public void setName(String name) {        this.name = name;
    }    public String getValue() {        return value;
    }    public void setValue(String value) {        this.value = value;
    }
}

可以看出上面的代码中除了声明了新的ItemInfo实体类以外,其余全部使用了已有的方法并且是MultiItem库中已经定义好的基础类。所以用起来还是很轻的,希望大家多多尝试。

总结

状态界面采用辅助类的方式实现,没有侵入原有的业务代码,并且对于每种状态会生成对应的实例去管理,使用起来更灵活,更简洁。详情界面是对已有功能的一个实践,可能用户详情这个例子并不是特别适合,但是前面提到的文章详情界面应该更有说服力。期待大家多多挖掘实用的功能,欢迎大家多多交流。

原文链接:http://www.apkbus.com/blog-900745-63536.html

打开App,阅读手记
0人推荐
发表评论
随时随地看视频慕课网APP