Android BaseQu android BaseQuickAdapter

转载

落花有意飞花 2023-11-09 07:16:46

文章标签 Android BaseQu android万能适配器 android 控件 ide 文章分类 Android 移动开发

RecycleView万能适配器

一导入

implementation 'com.github.CymChad:BaseRecyclerViewAdapterHelper:2.9.24'
implementation 'com.android.support:recyclerview-v7:25.3.1'

allprojects {
        repositories {
            ...
            maven { url "https://jitpack.io" }
        }
    }

二:基本应用

activity_main xml文件

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <android.support.v7.widget.RecyclerView
        android:id="@+id/recycler_view"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
</RelativeLayout>

2.条目布局文件

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="5dp">



    <TextView
        android:id="@+id/tv_title"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_vertical"
        android:layout_marginLeft="10dp"
        android:layout_marginTop="10dp"
        android:text="我是标题"
        android:textColor="#f00"
        android:textSize="20dp" />

    <TextView
        android:id="@+id/tv_age"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_toRightOf="@+id/tv_title"
        android:layout_marginLeft="10dp"
        android:textSize="20dp"
        android:layout_marginTop="10dp"
        android:text="我年龄" />

    <TextView
        android:id="@+id/tv_content"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_below="@+id/tv_title"
        android:textSize="18dp"
        android:layout_marginLeft="10dp"
        android:layout_marginTop="10dp"
        android:text="我是描述" />
</RelativeLayout>

3.编写数据实体类型

public class Person {
    private String name;
    private int age;
    private String des;
    
   生成 get set方法
}

编写适配器

public class QuickAdapter extends BaseQuickAdapter<Person, BaseViewHolder> {

    private Context context;

    public QuickAdapter(int layoutResId, @Nullable List<Person> data, Context context) {
        super(layoutResId, data);
        this.context = context;
    }

    @SuppressLint("ResourceAsColor")
    @Override
    protected void convert(@NonNull BaseViewHolder helper, Person item) {
        helper.setText(R.id.tv_title, item.getName()+"")
                .setTextColor(R.id.tv_title, context.getResources().getColor(R.color.colorPrimary))
                .setText(R.id.tv_age, item.getAge()+"")
                .setText(R.id.tv_content, item.getDes()+"")
                .setTextColor(R.id.tv_content, context.getResources().getColor(R.color.colorAccent));

    }
}

5: 最后一步：在Activity中使用该适配器

public class MainActivity extends AppCompatActivity {
    private RecyclerView recyclerView;
    private QuickAdapter adapter;
    private ArrayList<Person> list;


    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        recyclerView =findViewById(R.id.recycler_view);
        list =new ArrayList<>();
        for (int i = 0; i < 20; i++) {
            Person person =new Person();
            person.setAge(i);
            person.setName("我是第"+i+"条数据");
            person.setDes("我是描述"+i);
            list.add(person);
        }
        LinearLayoutManager manager =new LinearLayoutManager(this);
        manager.setOrientation(LinearLayoutManager.VERTICAL);
        recyclerView.setLayoutManager(manager);

        adapter =new QuickAdapter(R.layout.item_rv,list,this);
        recyclerView.setAdapter(adapter);
    }
}

三:点击事件
1:Item的点击事件

adapter.setOnItemClickListener(new BaseQuickAdapter.OnItemClickListener() {
            @Override
            public void onItemClick(BaseQuickAdapter adapter, View view, int position) {
                Toast.makeText(MainActivity.this, "点击了第"+position+"条目", Toast.LENGTH_SHORT).show();
            }
        });

2:长按点击事件

adapter.setOnItemLongClickListener(new BaseQuickAdapter.OnItemLongClickListener() {
            @Override
            public boolean onItemLongClick(BaseQuickAdapter adapter, View view, int position) {
                Toast.makeText(MainActivity.this, "长按"+position+"条目", Toast.LENGTH_SHORT).show();
                return false;
            }
        });

3:条目子控件事件
首先,在adapter的convert方法里面通过 helper.addOnClickListener 绑定一下子控件的控件id

@SuppressLint("ResourceAsColor")
    @Override
    protected void convert(@NonNull BaseViewHolder helper, Person item) {
        helper.setText(R.id.tv_title, item.getName()+"")
                .setTextColor(R.id.tv_title, context.getResources().getColor(R.color.colorPrimary))
                .setText(R.id.tv_age, item.getAge()+"")
                .setText(R.id.tv_content, item.getDes()+"")
                .setTextColor(R.id.tv_content, context.getResources().getColor(R.color.colorAccent))
                .addOnClickListener(R.id.tv_title); //给标题增加点击事件
    }

然后设置

//条目子控件事件
        adapter.setOnItemChildClickListener(new BaseQuickAdapter.OnItemChildClickListener() {
            @Override
            public void onItemChildClick(BaseQuickAdapter adapter, View view, int position) {
                //多个事件
                Toast.makeText(MainActivity.this, "标题子控件点击"+position+"条目", Toast.LENGTH_SHORT).show();
                }
            }
        });

4:Item子控件的长按事件 跟点击条目控件事件做法相同
5:多个Item子控件事件
首先绑定

@SuppressLint("ResourceAsColor")
    @Override
    protected void convert(@NonNull BaseViewHolder helper, Person item) {
        helper.setText(R.id.tv_title, item.getName()+"")
                .setTextColor(R.id.tv_title, context.getResources().getColor(R.color.colorPrimary))
                .setText(R.id.tv_age, item.getAge()+"")
                .setText(R.id.tv_content, item.getDes()+"")
                .setTextColor(R.id.tv_content, context.getResources().getColor(R.color.colorAccent))
                .addOnClickListener(R.id.tv_title) //给标题增加点击事件
                .addOnClickListener(R.id.tv_content)给描述增加点击事件;
              
    }

然后区分id

adapter.setOnItemChildClickListener(new BaseQuickAdapter.OnItemChildClickListener() {
            @Override
            public void onItemChildClick(BaseQuickAdapter adapter, View view, int position) {
                //多个事件
                switch (view.getId()){
                    case R.id.tv_title:
                        Toast.makeText(MainActivity.this, "标题子控件点击"+position+"条目", Toast.LENGTH_SHORT).show();
                      
                        break;
                    case R.id.tv_content:
                        Toast.makeText(MainActivity.this, "描述子控件点击"+position+"条目", Toast.LENGTH_SHORT).show();
                        break;
                }
            }
        });

那么如果是长按事件呢？当然也是相同的处理方法。

6如果需要在子控件事件中获取其他子控件可以使用：

getViewByPosition(RecyclerView recyclerView, int position, @IdRes int viewId)

adapter.setOnItemChildClickListener(new BaseQuickAdapter.OnItemChildClickListener() {
            @Override
            public void onItemChildClick(BaseQuickAdapter adapter, View view, int position) {
                //多个事件
                switch (view.getId()){
                    case R.id.tv_title:
                        Toast.makeText(MainActivity.this, "标题子控件点击"+position+"条目", Toast.LENGTH_SHORT).show();
                        // TODO 子控件事件中获取其他子控件可以使用
                        //TODO getViewByPosition(RecyclerView recyclerView, int position, @IdRes int viewId)
                        TextView tv_title = (TextView) adapter.getViewByPosition(recyclerView, position, R.id.tv_title);
                        Log.e("wudi", "onItemChildClick: tv_title.getText()="+tv_title.getText() );
                        TextView tv_content = (TextView) adapter.getViewByPosition(recyclerView, position, R.id.tv_content);
                        Log.e("wudi", "onItemChildClick: tv_content.getText()="+tv_content.getText() );
                        break;
                    case R.id.tv_content:
                        Toast.makeText(MainActivity.this, "描述子控件点击"+position+"条目", Toast.LENGTH_SHORT).show();
                        break;
                }
            }
        });

四、添加列表加载动画
1://开启动画（默认为渐显效果）
adapter.openLoadAnimation();
2:五种状态（渐显、缩放、从下到上，从左到右、从右到左）

public static final int ALPHAIN = 0x00000001;
    /**
     * Use with {@link #openLoadAnimation}
     */
    public static final int SCALEIN = 0x00000002;
    /**
     * Use with {@link #openLoadAnimation}
     */
    public static final int SLIDEIN_BOTTOM = 0x00000003;
    /**
     * Use with {@link #openLoadAnimation}
     */
    public static final int SLIDEIN_LEFT = 0x00000004;
    /**
     * Use with {@link #openLoadAnimation}
     */
    public static final int SLIDEIN_RIGHT = 0x00000005;

//使用缩放
adapter.openLoadAnimation(BaseQuickAdapter.SCALEIN);

如果想自定义动画，该适配器也提供了接口

//自定义动画效果
        adapter.openLoadAnimation(new BaseAnimation() {
            @Override
            public Animator[] getAnimators(View view) {
                return new Animator[]{
                        ObjectAnimator.ofFloat(view, "scaleY", 1, 0.5f, 1),
                        ObjectAnimator.ofFloat(view, "scaleX", 1, 0.5f, 1)
                };
            }
        });

动画默认只执行一次，如果想重复执行可设置

//设置重复执行动画
adapter.isFirstOnly(false);

设置不显示动画数量(老实讲，我没明白这个方法的效果是啥，因为我并没有看到效果 0.0

adapter.setNotDoAnimationCount(count);

首次到界面的item每次都依次执行加载动画
由于进入界面的item都是很多的速度进来的所以不会出现滑动显示的依次执行动画效果，这个时候会一起执行动画，如果觉得这样的效果不好可以使用setNotDoAnimationCount设置第一屏item不执行动画，但是如果需要依次执行动画可以重写startAnim让第一个屏幕的item动画延迟执行即可。

@Override
    protected void startAnim(Animator anim, int index) {
        super.startAnim(anim, index);
        if (index < count)
        anim.setStartDelay(index * 150);
    }

五:添加头部、尾部

View headView = View.inflate(MainActivity.this, R.layout.head_view, null);
        View footView = View.inflate(MainActivity.this, R.layout.foot_view, null);
        adapter.addHeaderView(headView);
        adapter.addFooterView(footView);

删除指定view

adapter.removeHeaderView(headView);
        adapter.removeFooterView(footView);

删除所有布局

adapter.removeAllHeaderView();
        adapter.removeAllFooterView();

出现了头布局就不会显示Empty

adapter.setHeaderAndEmpty(true);
adapter.setHeaderFooterEmpty(true,true);

六、上拉加载
1:创建一个数据管理

public class DataServer {

    //分页加载数据
    public static List<Person> getData(int lenth) {
        List<Person> list = new ArrayList<>();
        for (int i = 0; i < lenth; i++) {
            Person person = new Person();
            person.setName("name"+i);
            person.setDes("描述"+i);
            person.setAge(i);
            list.add(person);
        }
        return list;
    }
}

2:设置上啦加载

//当前个数
    private  int mCurrentCounter =0;
    //总数
    private  int TOTAL_COUNTER =100;
    //每次取多少个
    private  int PAGE_SIZE =10;
    //是否加载失败
    private boolean isErr =true;

 adapter.setOnLoadMoreListener(new BaseQuickAdapter.RequestLoadMoreListener() {
            @Override
            public void onLoadMoreRequested() {
                recyclerView.postDelayed(new Runnable() {
                    @Override
                    public void run() {
                        if (mCurrentCounter >= TOTAL_COUNTER) {
                            //数据全部加载完毕
                            adapter.loadMoreEnd();
                        } else {
                            if (isErr) {
                                //成功获取更多数据（可以直接往适配器添加数据）
                                adapter.addData(DataServer.getData(PAGE_SIZE));
                                mCurrentCounter = adapter.getData().size();
                                //主动调用加载完成，停止加载
                                adapter.loadMoreComplete();
                            } else {
                                //获取更多数据失败
                                isErr = true;
                                Toast.makeText(MainActivity.this, R.string.network_err, Toast.LENGTH_LONG).show();
                                //同理，加载失败也要主动调用加载失败来停止加载（而且该方法会提示加载失败）
                                adapter.loadMoreFail();

                            }
                        }
                    }

                }, 300);
            }
        },recyclerView);

加载完成（注意不是加载结束，而是本次数据加载结束并且还有下页数据）

adapter.loadMoreComplete()

加载失败

adapter.loadMoreFail();

加载结束

adapter.loadMoreEnd();

注意：如果上拉结束后，下拉刷新需要再次开启上拉监听，需要使用setNewData方法填充数据。
打开或关闭加载（一般用于下拉的时候做处理，因为上拉下拉不能同时操作）

adapter.setEnableLoadMore(boolean);

预加载(这个功能屌炸天)

// 当列表滑动到倒数第N个Item的时候(默认是1)回调onLoadMoreRequested方法
adapter.setPreLoadNumber(int);
adapter.setPreLoadNumber(3);

设置自定义加载布局

adapter.setLoadMoreView(new CustomLoadMoreView());

public final class CustomLoadMoreView extends LoadMoreView {

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

    /**
     * 如果返回true，数据全部加载完毕后会隐藏加载更多
     * 如果返回false，数据全部加载完毕后会显示getLoadEndViewId()布局
     */
    @Override
    public boolean isLoadEndGone() {
        return true;
    }

    @Override
    protected int getLoadingViewId() {
        return R.id.load_more_loading_view;
    }

    @Override
    protected int getLoadFailViewId() {
        return R.id.load_more_load_fail_view;
    }

    /**
     * isLoadEndGone()为true，可以返回0
     * isLoadEndGone()为false，不能返回0
     */
    @Override
    protected int getLoadEndViewId() {
        return 0;
    }
}

七、下拉加载（符合聊天软件下拉历史数据需求）

mAdapter.setUpFetchEnable(true);

mAdapter.setUpFetchListener(new BaseQuickAdapter.UpFetchListener() {
            @Override
            public void onUpFetch() {
                startUpFetch();
            }
        });
private void startUpFetch() {
        count++;
        /**
         * set fetching on when start network request.
         */
        mAdapter.setUpFetching(true);
        /**
         * get data from internet.
         */
        mRecyclerView.postDelayed(new Runnable() {
            @Override
            public void run() {
                mAdapter.addData(0, genData());
                /**
                 * set fetching off when network request ends.
                 */
                mAdapter.setUpFetching(false);
                /**
                 * set fetch enable false when you don't need anymore.
                 */
                if (count > 5) {
                    mAdapter.setUpFetchEnable(false);
                }
            }
        }, 300);
    }

八:多布局
1:实体类

public class Person {
    private String name;
    private int age;
    private String des;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    public String getDes() {
        return des;
    }

    public void setDes(String des) {
        this.des = des;
    }
}

2:多布局设置类型 MultipleItem implements MultiItemEntity

/**
 * 多布局展示
 * */
//实体类必须实现MultiItemEntity，在设置数据的时候，需要给每一个数据设置itemType
public class MultipleItem implements MultiItemEntity {

    public static final int FIRST_TYPE = 1;
    public static final int SECOND_TYPE = 2;
    public static final int NORMAL_TYPE = 3;

    private int itemType;
    private Person person;

    public MultipleItem(int itemType, Person person) {
        this.itemType = itemType;
        this.person = person;
    }

    @Override
    public int getItemType() {
        return itemType;
    }
    public Person getPerson(){
        return person;
    }
}

3:适配器继承 BaseMultiItemQuickAdapter
addItemType 区分类型
helper.getItemViewType() 实现多布局展示

/**
 * 多布局adapter
 * */
public class MoreQuickAdapter extends BaseMultiItemQuickAdapter<MultipleItem, BaseViewHolder> {

    private Context context;

    public MoreQuickAdapter(List<MultipleItem> data, Context context) {
        super(data);
        this.context = context;
        addItemType(MultipleItem.FIRST_TYPE, R.layout.first_type_layout);
        addItemType(MultipleItem.SECOND_TYPE, R.layout.second_type_layout);
        addItemType(MultipleItem.NORMAL_TYPE, R.layout.item_rv);
    }

    @Override
    protected void convert(@NonNull BaseViewHolder helper, MultipleItem item) {

        switch (helper.getItemViewType()) {
            case MultipleItem.FIRST_TYPE:
                helper.setText(R.id.tv_title,item.getPerson().getName()+"布局一")
                        .setTextColor(R.id.tv_title,context.getResources().getColor(R.color.colorAccent))
                        .setText(R.id.tv_age,item.getPerson().getAge()+"")
                        .setTextColor(R.id.tv_age,context.getResources().getColor(R.color.colorAccent))
                        .setText(R.id.tv_content,item.getPerson().getDes()+"")
                        .setTextColor(R.id.tv_content,context.getResources().getColor(R.color.colorAccent));
                break;
            case MultipleItem.SECOND_TYPE:
                helper.setText(R.id.tv_title,item.getPerson().getName()+"布局二")
                        .setTextColor(R.id.tv_title,context.getResources().getColor(R.color.colorPrimary))
                        .setText(R.id.tv_age,item.getPerson().getAge()+"")
                        .setTextColor(R.id.tv_age,context.getResources().getColor(R.color.colorPrimary))
                        .setText(R.id.tv_content,item.getPerson().getDes()+"")
                        .setTextColor(R.id.tv_content,context.getResources().getColor(R.color.colorPrimary));
                break;
            case MultipleItem.NORMAL_TYPE:
                helper.setText(R.id.tv_title,item.getPerson().getName()+"正常")
                        .setTextColor(R.id.tv_title,context.getResources().getColor(R.color.color1bd))
                        .setText(R.id.tv_age,item.getPerson().getAge()+"")
                        .setTextColor(R.id.tv_age,context.getResources().getColor(R.color.color1bd))
                        .setText(R.id.tv_content,item.getPerson().getDes()+"")
                        .setTextColor(R.id.tv_content,context.getResources().getColor(R.color.color1bd));
                break;
        }
    }
}

4:activity

private RecyclerView recyclerView;
    private ArrayList<Person> data;
    private ArrayList<MultipleItem> multipleItems;
    private MoreQuickAdapter adapter;

recyclerView =findViewById(R.id.recycler_view);
        data =new ArrayList<>();
        multipleItems =new ArrayList<>();
        for (int i = 0; i < 30; i++) {
            Person person =new Person();
            person.setAge(i);
            person.setName("name"+i);
            person.setDes("描述"+i);
            data.add(person);
        }
        //这里我是随机给某一条目加载不同的布局
        for (int i = 0; i < 30; i++) {
            if (i % 3 == 0) {
                multipleItems.add(new MultipleItem(MultipleItem.FIRST_TYPE, data.get(i)));
            } else if (i % 7 == 0) {
                multipleItems.add(new MultipleItem(MultipleItem.SECOND_TYPE, data.get(i)));
            } else {
                multipleItems.add(new MultipleItem(MultipleItem.NORMAL_TYPE, data.get(i)));
            }
        }

        LinearLayoutManager manager =new LinearLayoutManager(this);
        manager.setOrientation(LinearLayoutManager.VERTICAL);
        recyclerView.setLayoutManager(manager);
        adapter =new MoreQuickAdapter(multipleItems,this);
        recyclerView.setAdapter(adapter);

十:添加拖拽、滑动删除
拖拽和滑动删除的回调方法：

public class ItemDragAdapter extends BaseItemDraggableAdapter<Person,BaseViewHolder> {

    public ItemDragAdapter(int layoutResId, List<Person> data) {
        super(layoutResId, data);
    }

    @Override
    protected void convert(@NonNull BaseViewHolder helper, Person item) {
        helper.setText(R.id.tv_title,item.getName()+"")
                .setText(R.id.tv_age,item.getAge()+"")
                .setText(R.id.tv_content,item.getDes()+"");

    }
}

activity:

LinearLayoutManager manager = new LinearLayoutManager(this);
        manager.setOrientation(LinearLayoutManager.VERTICAL);
        recyclerView.setLayoutManager(manager);

        adapter = new ItemDragAdapter(R.layout.second_type_layout,data);

        ItemDragAndSwipeCallback itemDragAndSwipeCallback = new ItemDragAndSwipeCallback(adapter);
        ItemTouchHelper itemTouchHelper = new ItemTouchHelper(itemDragAndSwipeCallback);
        itemTouchHelper.attachToRecyclerView(recyclerView);

        // 开启拖拽
        adapter.enableDragItem(itemTouchHelper, R.id.rl_layout, true);
        adapter.setOnItemDragListener(onItemDragListener);

        // 开启滑动删除
        adapter.enableSwipeItem();
        adapter.setOnItemSwipeListener(onItemSwipeListener);

        recyclerView.setAdapter(adapter);

OnItemDragListener onItemDragListener =new OnItemDragListener() {
        @Override
        public void onItemDragStart(RecyclerView.ViewHolder viewHolder, int pos) {
            Log.e("wudi", "onItemDragStart: "+pos );
        }

        @Override
        public void onItemDragMoving(RecyclerView.ViewHolder source, int from, RecyclerView.ViewHolder target, int to) {
            Log.e("wudi", "onItemDragMoving: from="+from+",to="+to );
        }

        @Override
        public void onItemDragEnd(RecyclerView.ViewHolder viewHolder, int pos) {
            Log.e("wudi", "onItemDragEnd: "+pos );
        }
    };
    OnItemSwipeListener  onItemSwipeListener =new OnItemSwipeListener () {

        @Override
        public void onItemSwipeStart(RecyclerView.ViewHolder viewHolder, int pos) {
            Log.e("wudi", "onItemSwipeStart: "+pos );
        }

        @Override
        public void clearView(RecyclerView.ViewHolder viewHolder, int pos) {

        }

        @Override
        public void onItemSwiped(RecyclerView.ViewHolder viewHolder, int pos) {

        }

        @Override
        public void onItemSwipeMoving(Canvas canvas, RecyclerView.ViewHolder viewHolder, float dX, float dY, boolean isCurrentlyActive) {

        }
    };

新增
适配器设置数据,设置点击固定数据的点击事件

Log.e(TAG, "convert:helper.getLayoutPosition()= "+helper.getLayoutPosition() );
        switch (helper.getLayoutPosition() % 3) {
            case 0:
                helper.setImageResource(R.id.image, R.mipmap.animation_img1);
                break;
            case 1:
                helper.setImageResource(R.id.image, R.mipmap.animation_img2);
                break;
            case 2:
                helper.setImageResource(R.id.image, R.mipmap.animation_img3);
                break;
            default:
                break;
        }

/**
         * 设置tv_title 样式
         * */
        helper.setText(R.id.tv_title,SpannableStringUtils.getBuilder(item.getName()).append("landscapes and nedes")
                    .setClickSpan(clickableSpan)
                    .setBoldItalic()
                .setProportion(1.5f)
                .setStrikethrough()
                .setUnderline()
                .setSuperscript()
                .setSubscript()
                .setQuoteColor(R.color.color1bd)
                .create()); //给标题增加点击事件;
        ((TextView) helper.getView(R.id.tv_title)).setMovementMethod(ClickableMovementMethod.getInstance());
        ((TextView) helper.getView(R.id.tv_title)).setFocusable(false);
        ((TextView) helper.getView(R.id.tv_title)).setClickable(false);
        ((TextView) helper.getView(R.id.tv_title)).setLongClickable(false);

//点击
 private ClickableSpan clickableSpan = new ClickableSpan() {
        @Override
        public void onClick(View widget) {
            ToastUtils.showShortToast("事件触发了 landscapes and nedes");
        }

        @Override
        public void updateDrawState(TextPaint ds) {
            ds.setColor(content.getResources().getColor(R.color.colorAccent));
            ds.setUnderlineText(true);
        }
    };

本文章为转载内容，我们尊重原作者对文章享有的著作权。如有内容错误或侵权问题，欢迎原作者联系我们进行内容更正或删除文章。