baseAdapter

Introduction: Android 万能的 Adapter for ListView,RecyclerView,GridView 等,支持多种 Item 类型的情况。
More: Author   ReportBugs   
Tags:

Android 万能的 Adapter for ListView,RecyclerView,GridView 等,支持多种 Item 类型的情况。

引入

ForRecyclerView

compile 'com.zhy:base-rvadapter:3.0.3'

ForListView

compile 'com.zhy:base-adapter:3.0.3'

使用

(1)简单的数据绑定(ListView 与其使用方式一致)

首先看我们最常用的单种 Item 的书写方式:

mRecyclerView.setAdapter(new CommonAdapter<String>(this, R.layout.item_list, mDatas)
{
    @Override
    public void convert(ViewHolder holder, String s)
    {
        holder.setText(R.id.id_item_list_title, s);
    }
});

是不是相当方便,在 convert 方法中完成数据、事件绑定即可。

只需要简单的将 Adapter 继承 CommonAdapter,复写 convert 方法即可。省去了自己编写 ViewHolder 等大量的重复的代码。

  • 可以通过 holder.getView(id)拿到任何控件。
  • ViewHolder 中封装了大量的常用的方法,比如 holder.setText(id,text),holder.setOnClickListener(id,listener)等,可以支持使用。

效果图:

(2)多种 ItemViewType(ListView 与其使用方式一致)

对于多中 itemviewtype 的处理参考:https://github.com/sockeqwe/AdapterDelegates ,具有极高的扩展性。

MultiItemTypeAdapter adapter = new MultiItemTypeAdapter(this,mDatas);
adapter.addItemViewDelegate(new MsgSendItemDelagate());
adapter.addItemViewDelegate(new MsgComingItemDelagate());

每种 Item 类型对应一个 ItemViewDelegete,例如:

public class MsgComingItemDelagate implements ItemViewDelegate<ChatMessage>
{

    @Override
    public int getItemViewLayoutId()
    {
        return R.layout.main_chat_from_msg;
    }

    @Override
    public boolean isForViewType(ChatMessage item, int position)
    {
        return item.isComMeg();
    }

    @Override
    public void convert(ViewHolder holder, ChatMessage chatMessage, int position)
    {
        holder.setText(R.id.chat_from_content, chatMessage.getContent());
        holder.setText(R.id.chat_from_name, chatMessage.getName());
        holder.setImageResource(R.id.chat_from_icon, chatMessage.getIcon());
    }
}

贴个效果图:

(3) 添加 HeaderView、FooterView

mHeaderAndFooterWrapper = new HeaderAndFooterWrapper(mAdapter);

TextView t1 = new TextView(this);
t1.setText("Header 1");
TextView t2 = new TextView(this);
t2.setText("Header 2");
mHeaderAndFooterWrapper.addHeaderView(t1);
mHeaderAndFooterWrapper.addHeaderView(t2);

mRecyclerView.setAdapter(mHeaderAndFooterWrapper);
mHeaderAndFooterWrapper.notifyDataSetChanged();

类似装饰者模式,直接将原本的 adapter 传入,初始化一个 HeaderAndFooterWrapper 对象,然后调用相关 API 添加。

(4) 添加 LoadMore

mLoadMoreWrapper = new LoadMoreWrapper(mOriginAdapter);
mLoadMoreWrapper.setLoadMoreView(R.layout.default_loading);
mLoadMoreWrapper.setOnLoadMoreListener(new LoadMoreWrapper.OnLoadMoreListener()
{
    @Override
    public void onLoadMoreRequested()
    {
    }
});

mRecyclerView.setAdapter(mLoadMoreWrapper);

直接将原本的 adapter 传入,初始化一个 LoadMoreWrapper 对象,然后调用相关 API 即可。

(5)添加 EmptyView

mEmptyWrapper = new EmptyWrapper(mAdapter);
mEmptyWrapper.setEmptyView(R.layout.empty_view);

mRecyclerView.setAdapter(mEmptyWrapper );

直接将原本的 adapter 传入,初始化一个 EmptyWrapper 对象,然后调用相关 API 即可。

支持链式添加多种功能,示例代码:

mAdapter = new EmptyViewWrapper(
    new LoadMoreWrapper(
    new HeaderAndFooterWrapper(mOriginAdapter)));

一些回调

onViewHolderCreated

mListView.setAdapter(new CommonAdapter<String>(this, R.layout.item_list, mDatas)
{
    @Override
    public void convert(ViewHolder holder, String o, int pos)
    {
        holder.setText(R.id.id_item_list_title, o);
    }

    @Override
    public void onViewHolderCreated(ViewHolder holder, View itemView)
    {
        super.onViewHolderCreated(holder, itemView);
       //AutoUtil.autoSize(itemView)
    }
});

感谢

Apps
About Me
GitHub: Trinea
Facebook: Dev Tools