Android 通过RecyclerView Adapter设置空布局

在Android开发中,列表无数据时,一般会显示一个空布局。普遍的做法是把列表布局(如:RecyclerView)和空布局都写在布局文件(xml)里,通过对列表和空布局的隐藏/显示来切换需要显示的控件。如果我们有很多页面都需要显示这种空布局,就需要每个页面都要写重复的代码。这种方法不仅耦合度高,而且实现和维护麻烦。网上也有把空布局封装成公共组件,通过给空布局组件设置需要替换的目标控件,把目标控件(如:RecyclerView)替换掉的做法。这两种做法其实都是通过切换显示不同的控件来实现功能的,而且都需要我们自己去操作列表和空布局之间的切换。那么有没有不需要切换控件,就可以让我们的列表在无数据时自动显示一个空布局的方法呢。答案肯定是有的,今天我就给大家介绍一种通过给RecyclerView设置空布局item实现空布局显示的方法。

显示列表一般是使用RecyclerView,RecyclerView的显示内容是由Adapter提供和管理的。Adapter知道RecyclerView是否有数据,如果没有数据时,由Adapter提供一个空布局给RecyclerView显示,这样RecyclerView的空布局功能能就实现了。因为RecyclerView支持多种ViewType的item,所以我们可以把空布局作为一个ViewType,。当无数据时,getItemCount返回1,让RecyclerView显示一个item,这个item就是我们要显示的空布局。item的ViewType为TYPE_EMPTY(可随便定义,只要不跟普通的item冲突即可),item的宽高为match_parent,这样空布局就可以铺面RecyclerView。

public class EmptyAdapter extends RecyclerView.Adapter<EmptyAdapter.ViewHolder> {

    // 普通的item ViewType
    private static final int TYPE_ITEM = 1;
    // 空布局的ViewType
    private static final int TYPE_EMPTY = 2;

    private Context mContext;

    // 数据
    private List<String> mList;

    // 是否显示空布局,默认不显示
    private boolean showEmptyView = false;

    public EmptyAdapter(Context context) {
        mContext = context;
    }

    @NonNull
    @Override
    public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        if (viewType == TYPE_EMPTY) {
            // 创建空布局item
            return new ViewHolder(getEmptyView(parent));
        } else {
            // 创建普通的item
            View view = LayoutInflater.from(mContext).inflate(R.layout.adapter_item, parent, false);
            return new ViewHolder(view);
        }
    }

    /**
     * 获取空布局
     */
    private View getEmptyView(ViewGroup parent) {
        View view = LayoutInflater.from(mContext).inflate(R.layout.adapter_empty_view, parent, false);
        Button btnLoadData = view.findViewById(R.id.btn_load_data);
        btnLoadData.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                setList(initData());
            }
        });
        return view;
    }

    @Override
    public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
        // 如果是空布局item,不需要绑定数据
        if (!isEmptyPosition(position)) {
            holder.tvItem.setText(mList.get(position));
        }
    }

    @Override
    public int getItemCount() {
        // 判断数据是否空,如果没有数据,并且需要显示空布局,就返回1。
        int count = mList != null ? mList.size() : 0;
        if (count > 0) {
            return count;
        } else if (showEmptyView) {
            // 显示空布局
            return 1;
        } else {
            return 0;
        }
    }

    @Override
    public int getItemViewType(int position) {
        if (isEmptyPosition(position)) {
            // 空布局
            return TYPE_EMPTY;
        } else {
            return TYPE_ITEM;
        }
    }

    public void setList(List<String> list) {
        mList = list;
        notifyDataSetChanged();
    }

    /**
     * 判断是否是空布局
     */
    public boolean isEmptyPosition(int position) {
        int count = mList != null ? mList.size() : 0;
        return position == 0 && showEmptyView && count == 0;
    }

    /**
     * 设置空布局显示。默认不显示
     */
    public void showEmptyView(boolean isShow) {
        if (isShow != showEmptyView) {
            showEmptyView = isShow;
            notifyDataSetChanged();
        }
    }

    public boolean isShowEmptyView() {
        return showEmptyView;
    }

    static class ViewHolder extends RecyclerView.ViewHolder {

        TextView tvItem;

        public ViewHolder(@NonNull View itemView) {
            super(itemView);

            tvItem = itemView.findViewById(R.id.tv_item);
        }
    }

}

由于列表中的空布局最多只会有一个,所以它不需要在onBindViewHolder中重新绑定数据。我们在创建空布局的时候就可以直接给它设置需要显示的内容和设置点击事件。

在上面的例子中,我通过getEmptyView方法提供空布局对象。这样做是为了让空布局和adapter解耦,不过在这个例子中没有明显的体现出来。试想,如果我们通过一个方法或者接口提供需要的空布局,那么我们就可以让具体的adapter子类(或者使用者)试下这个方法(实现接口),由子类或者外部提供具体的空布局,让空布局可自定义,而且不会影响adapter的基本功能。比如我们项目中一般都会封装一个BaseAdapter类,或者使用第三方开源的BaseAdapter,项目中的adapter都继承自BaseAdapter。我们可以把空布局的功能集成在BaseAdapter,并且提供默认的通用空布局。然后子类可通过重写方法提供自己的空布局,这样就让空布局可自定义了。把空布局功能集成到adapter后,直接使用这个adapter,在没有数据时就会显示空布局了,而且无需我们手动地调用空布局的显示或者隐藏。

mAdapter = new EmptyAdapter(this);
// 显示空布局
mAdapter.showEmptyView(true);
rvList.setLayoutManager(new LinearLayoutManager(this));
rvList.setAdapter(mAdapter);

如果是使用GridLayoutManager,为了能让空布局铺面RecyclerView,需要setSpanSizeLookup。

    final GridLayoutManager layoutManager = new GridLayoutManager(this, 2);
    layoutManager.setSpanSizeLookup(new GridLayoutManager.SpanSizeLookup() {
        @Override
        public int getSpanSize(int position) {
            // 如果是空布局,让它占满一行
            if (mAdapter.isEmptyPosition(position)) {
                return layoutManager.getSpanCount();
            }
            return 1;
        }
    });
    rvList.setLayoutManager(layoutManager);

到这里,空布局的实现就完成了。有兴趣的朋友可以体验一下我在GitHub提供的例子:EmptyAdapter

之所以考虑把空布局功能集成到adapter中,是因为我之前在GitHub开源了一个可分组的RecyclerView Adapter:GroupedRecyclerViewAdapter。后面收到不少反馈,希望GroupedRecyclerViewAdapter能提供空布局的设置,所以我就想出了这种实现方式,并且给GroupedRecyclerViewAdapter集成了这个功能。今天写这篇文章,是希望能把这种实现方法分享给大家。虽然我们现在是给RecyclerView 的Adapter实现空布局,但是这种思路同样适用于ListView等列表控件。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335