Adapter 的使用 1

jacksky
发布于 2022-2-16 17:54
浏览
0收藏

BaseRecyclerViewAdapterHelper

 

说明

 

1、BaseQuickAdapter<T, VH>为最基本的类型,提供最基础的功能,所有子类都继承于此。

2、T为数据类型;VH为ViewHolder类型,如果不需要自定义,直接使用BaseViewHolder即可。

3、框架提供了一个基础BaseViewHolder,所有自定义的ViewHolder都应该继承于此!

 

BaseQuickAdapter<T, VH>

1、快速使用

 

BaseQuickAdapter<T, VH>为最基础的类型,直接使用BaseQuickAdapter<T, VH>即可简单快速实现一个Adapter:

public class DemoAdapter extends BaseQuickAdapter<String, BaseViewHolder> {

    /**
     * 构造方法,此示例中,在实例化Adapter时就传入了一个List。
     * 如果后期设置数据,不需要传入初始List,直接调用 super(layoutResId); 即可
     */
    public DemoAdapter(list List<String>) {
        super(R.layout.layout_demo, list);
    }

    /**
     * 在此方法中设置item数据
     */
    @Override
    protected void convert(@NotNull BaseViewHolder helper, @NotNull String item) {
        helper.setText(R.id.tweetName, "This is an Item, pos: " + (helper.getAdapterPosition() - getHeaderLayoutCount()));
    }
}

 

Activity中设置:

DemoAdapter adapter = new DemoAdapter(new ArrayList<String>());
mRecyclerView.setAdapter(adapter);
 
 // 设置新的数据方法
adapter.setNewData(list)

 

2、纯View创建Item
如果不想使用xml布局,想直接使用View代码方式创建,那么构造函数使用super(0),并且在Adapter中重写onCreateDefViewHolder方法:

public class DemoAdapter extends BaseQuickAdapter<String, BaseViewHolder> {

    public DemoAdapter(list List<String>) {
      	//布局传递0
      	super(0);
    }
    
    /**
     * 重写此方法,自己创建 View 用来构建 ViewHolder
     */
    @NotNull
    @Override
    protected BaseViewHolder onCreateDefViewHolder(@NotNull ViewGroup parent, int viewType) {
      	// 创建自己的布局
        FrameLayout layout = new FrameLayout(getContext());
        ...
        ...
        return createBaseViewHolder(layout);
    }

    @Override
    protected void convert(@NotNull BaseViewHolder helper, @NotNull String item) {
      	...
    }
}

3、BaseQuickAdapter 点击事件
Item 点击事件
代码如下:

DemoAdapter adapter = new DemoAdapter();

// 设置点击事件
adapter.setOnItemClickListener(new OnItemClickListener() {
    @Override
    public void onItemClick(@NonNull BaseQuickAdapter adapter, @NonNull View view, int position) {
        Tips.show("onItemClick " + position);
    }
});

Item 长按事件
代码如下:

adapter.setOnItemLongClickListener(new OnItemLongClickListener() {
    @Override
    public boolean onItemLongClick(@NonNull BaseQuickAdapter adapter, @NonNull View view, int position) {
        Tips.show("onItemLongClick " + position);
        return true;
    }
});

 

Item 内子View的点击事件:
注意,请不要在convert方法里注册控件id

// 先注册需要点击的子控件id(注意,请不要写在convert方法里)
adapter.addChildClickViewIds(R.id.btn, R.id.iv_num_add, R.id.item_click);
// 设置子控件点击监听
adapter.setOnItemChildClickListener(new OnItemChildClickListener() {
    @Override
    public void onItemChildClick(@NonNull BaseQuickAdapter adapter, @NonNull View view, int position) {
        if (view.getId() == R.id.btn) {
            Tips.show("onItemChildClick " + position);
        }
    }
});

Item 内子View的长按事件:
注意,请不要在convert方法里注册控件id

// 先注册需要长按的子控件id(注意,请不要写在convert方法里)
adapter.addChildLongClickViewIds(R.id.btn, R.id.iv_num_add, R.id.item_click);
// 设置子控件长按监听
adapter.setOnItemChildLongClickListener(new OnItemChildLongClickListener() {
    @Override
    public boolean onItemChildLongClick(@NonNull BaseQuickAdapter adapter, @NonNull View view, int position) {
        if (view.getId() == R.id.btn) {
           Tips.show("onItemChildLongClick " + position);
        }
        return true;
    }
});

 

4、BaseQuickAdapter主要属性、方法说明

  Java Kotlin 说明
获取Context getContext() context  
数据相关      
获取Adapter中数据 getData() data 只能get
设置新的数据实例 setNewData() setNewData() 将会替换List指针引用
添加数据 addData() addData()  
移除数据 remove() remove()  
改变某一位置的数据 setData() setData()  
替换整个数据 replaceData() replaceData() 不会更改原数据的引用
设置Diff数据(异步,推荐) setDiffCallback() setDiffCallback() 配置数据差异化比较的Callback
  setDiffConfig() setDiffConfig() 更高程度的自定义化配置
  setDiffNewData(List) setDiffNewData(List?) 必须先设置setDiffCallback() 或者 setDiffConfig(),否则不生效
设置Diff数据 setDiffNewData(DiffResult, List) setDiffNewData(DiffResult, List?) 通过DiffResult设置数据,Adapter内部不关心Diff过程,只要结果。
空布局     仅当 data 为空时,才会显示
设置空布局视图 setEmptyView() setEmptyView()  
是否有空视图 hasEmptyView() hasEmptyView()  
获取空视图 getEmptyLayout() getEmptyLayout()  
是否使用空布局 setUseEmpty() isUseEmpty  
头布局      
添加头布局 addHeaderView() addHeaderView()  
设置头布局 setHeaderView() setHeaderView()  
是否有头布局 hasHeaderLayout() hasHeaderLayout()  
移除头布局 removeHeaderView() removeHeaderView()  
移除所有头布局 removeAllHeaderView() removeAllHeaderView()  
脚布局      
添加脚布局 addFooterView() addFooterView()  
设置脚布局 setFooterView() setFooterView()  
是否有脚布局 hasFooterLayout() hasFooterLayout()  
移除脚布局 removeFooterView() removeFooterView()  
移除所有脚布局 removeAllFooterView() removeAllFooterView()  
布局其他属性      
当显示空布局时,是否显示 头布局 setHeaderWithEmptyEnable() headerWithEmptyEnable  
当显示空布局时,是否显示 脚布局 setFooterWithEmptyEnable() footerWithEmptyEnable  
点击事件      
item点击事件 setOnItemClickListener() 同java  
item长按事件 setOnItemLongClickListener 同java  
item子view的点击事件 setOnItemChildClickListener 同java  
item子view的长按事件 setOnItemChildLongClickListener 同java  
添加需要响应点击事件的子View id addChildClickViewIds() 同java 添加以后,setOnItemChildClickListener才会响应
添加需要响应长按事件的子View id getChildLongClickViewIds() 同java  
动画      
是否打开动画 setAnimationEnable() animationEnable 默认:false
动画是否仅第一次执行 setAnimationFirstOnly() isAnimationFirstOnly  
设置自定义动画 setAdapterAnimation() adapterAnimation  
设置使用内置默认动画 setAnimationWithDefault() setAnimationWithDefault() 参数为枚举

BaseQuickAdapter 空布局\头部\脚部

 

1、空布局
说明:当adapter中数据不为空时,空布局不会生效

 

通过设置View为空布局
代码如下:

View view = ...
adapter.setEmptyView(view);

 

通过设置LayoutResId为空布局
代码如下:

adapter.setEmptyView(R.layout.loading_view);

 

设置是否使用空布局(默认为true)
代码如下:

// java
adapter.setUseEmpty(false);

// kotlin
adapter.isUseEmpty = false

 

2、头部
说明:此头部并不是item的头部,而是整个Adapter的头部

代码如下:

View view = ...;
adapter.addHeaderView(view);

// 指定添加位置
adapter.addHeaderView(view, 1);

// 替换头部
adapter.setHeaderView(view);
//替换指定位置头部
adapter.setHeaderView(view, 0);

// 移除头部
adapter.removeHeaderView(view);
// 移除全部头部
adapter.removeAllHeaderView();

 

3、脚部

说明:此脚部不是item的脚部,而是整个Adapter的

代码如下:

View view = ...;
adapter.addFooterView(view);

// 指定添加位置
adapter.addFooterView(view, 1);

// 替换脚部
adapter.setFooterView(view);
//替换指定位置脚部
adapter.setFooterView(view, 0);

// 移除脚部
adapter.removeFooterView(view);
// 移除全部脚部
adapter.removeAllFooterView();

 

DataBinding

 

基于 BaseQuickAdapter 的用法:
代码如下:

public class DataBindingAdapter extends BaseQuickAdapter<Movie, BaseViewHolder> {

    private MoviePresenter mPresenter = new MoviePresenter();

    public DataBindingAdapter() {
        super(R.layout.item_movie);
    }
		
    /**
     * 当 ViewHolder 创建完毕以后,会执行此回掉
     * 可以在这里做任何你想做的事情
     */
    @Override
    protected void onItemViewHolderCreated(@NotNull BaseViewHolder viewHolder, int viewType) {
        // 绑定 view
        DataBindingUtil.bind(viewHolder.itemView);
    }

    @Override
    protected void convert(@NotNull BaseViewHolder helper, @NotNull Movie item) {
        if (item == null) {
            return;
        }

        // 获取 Binding
        ItemMovieBinding binding = helper.getBinding();
        if (binding != null) {
            // 设置数据
            binding.setMovie(item);
            binding.setPresenter(mPresenter);
            binding.executePendingBindings();
        }
    }
}

 

基于 BaseProviderMultiAdapter 的用法
由于使用了Provider,所以相关事务并不在Adapter里处理。需要在Provider中对数据进行绑定。

Adapter代码如下(无需特殊处理,和普通的BaseProviderMultiAdapter写法一样):

public class ProviderMultiAdapter extends BaseProviderMultiAdapter<ProviderMultiEntity> {

    public ProviderMultiAdapter() {
        super();
        addItemProvider(new ImgItemProvider());
        addItemProvider(new TextImgItemProvider());
        addItemProvider(new TextItemProvider());
    }

    /**
     * 自行根据数据、位置等内容,返回 item 类型
     */
    @Override
    protected int getItemType(@NotNull List<? extends ProviderMultiEntity> data, int position) {
        switch (position % 3) {
            case 0:
                return ProviderMultiEntity.IMG;
            case 1:
                return ProviderMultiEntity.TEXT;
            case 2:
                return ProviderMultiEntity.IMG_TEXT;
            default:
                break;
        }
        return 0;
    }
}

 

Provider代码如下:

public class ImgItemProvider extends BaseItemProvider<ProviderMultiEntity> {

    @Override
    public int getItemViewType() {
        return ProviderMultiEntity.IMG;
    }

    @Override
    public int getLayoutId() {
        return R.layout.item_image_view;
    }

    /**
     * 当 ViewHolder 创建完毕以后,会执行此回掉
     * 可以在这里做任何你想做的事情
     */
    @Override
    public void onViewHolderCreated(@NotNull BaseViewHolder viewHolder) {
        // 绑定View
        DataBindingUtil.bind(viewHolder.itemView);
    }

    @Override
    public void convert(@NotNull BaseViewHolder helper, @NotNull ProviderMultiEntity data) {
        Movie movie = data.getMovie();
        // 获取 Binding
        ItemMovieBinding binding = helper.getBinding();
        if (binding != null) {
            binding.setMovie(movie);
            binding.executePendingBindings();
        }
    }

}

 

 

 

 

已于2022-2-16 17:54:42修改
收藏
回复
举报
回复
    相关推荐