CommonAdapter

Project Url: qyxxjd/CommonAdapter
Introduction: 一个适用于 ListView/GridView/RecyclerView 的 Adapter 库,简化大量重复代码,支持多种布局,可自定义图片加载的实现。
More: Author   ReportBugs   
Tags:

Download

  • 简化大量重复代码
  • 支持多布局
  • 自定义图片加载
  • 常用数据操作
  • view 复用
  • RecyclerView item 点击和长按事件

dependencies {
    implementation 'com.classic.adapter:commonadapter:2.0'
    implementation 'com.android.support:recyclerview-v7:27.0.2'
}

开始使用

ListView/GridView 使用示例

List<News> newsList = ...;
//单布局文件
listView = (ListView) findViewById(R.id.listview);
listView.setAdapter(new CommonAdapter<News>(context,
    //item 布局文件
    R.layout.item_none_picture, newsList ) {
    @Override public void onUpdate(BaseAdapterHelper helper, News item, int position) {
        //BaseAdapterHelper 详细用法,见下方

        helper.setText(R.id.xxx, item.getTitle())
               //1.如果已配置全局图片加载,这里可以不设置。全局图片加载配置见下方
               //2.有些项目可能使用多个图片加载库,这里可以针对当前 adapter 设置图片加载的实现方式,详见 demo
              .setImageLoad(new GlideImageLoad())
              .setImageUrl(R.id.xxx,item.getCoverUrl());
    }
});

//多布局文件
private final class MultipleLayoutAdapter extends CommonAdapter<News>{

    public MultipleLayoutAdapter(Context context, int layoutResId, List<News> data) {
        super(context, layoutResId, data);
    }
    //多种布局重写此方法即可
    @Override public int getLayoutResId(News item, int position) {
        int layoutResId = -1;
        switch (item.getNewsType()){
            case News.TYPE_NONE_PICTURE: //布局样式一
                layoutResId = R.layout.item_none_picture;
                break;
            case News.TYPE_SINGLE_PICTURE: //布局样式二
                layoutResId = R.layout.item_single_picture;
                break;
            case News.TYPE_MULTIPLE_PICTURE: //布局样式三
                layoutResId = R.layout.item_multiple_picture;
                break;

            更多的布局样式 ...
        }
        return layoutResId;
    }

    @Override public void onUpdate(BaseAdapterHelper helper, News item, int position) {
        switch (item.getNewsType()){
            case News.TYPE_NONE_PICTURE: //布局样式一
                helper.setText(R.id.xxx, item.getTitle())
                      .setImageUrl(R.id.xxx,item.getCoverUrl());
                break;
            case News.TYPE_SINGLE_PICTURE: //布局样式二
                helper.setText(R.id.xxx, item.getTitle())
                      .setImageUrl(R.id.xxx,item.getCoverUrl());
                break;
            case News.TYPE_MULTIPLE_PICTURE: //布局样式三
                helper.setText(R.id.xxx, item.getTitle())
                      .setImageUrl(R.id.xxx,item.getCoverUrl());
                break;

            更多的布局样式 ...
        }
    }
}

RecyclerView 使用示例

使用 DiffUtil 高效更新 RecyclerView 示例代码,点这里

List<News> newsList = ...;
//单布局文件
recyclerView = (RecyclerView) findViewById(R.id.recyclerview);
recyclerView.setLayoutManager(new LinearLayoutManager(this));
recyclerView.setHasFixedSize(true);
recyclerView.setItemAnimator(new DefaultItemAnimator());
newsAdapter = new NewsAdapter(this, R.layout.item_none_picture, newsList);
recyclerView.setAdapter(newsAdapter);

private class NewsAdapter extends CommonRecyclerAdapter<News>{

    public NewsAdapter(Context context, int layoutResId, List<News> data) {
        super(context, layoutResId, data);
    }

    @Override public void onCreate(RecyclerView.ViewHolder viewHolder, BaseAdapterHelper helper) {
        // ViewHolder 创建时回调
    }

    @Override public void onUpdate(BaseAdapterHelper helper, News item, int position) {
        helper.setText(R.id.xxx, item.getTitle())
              .setImageUrl(R.id.xxx,item.getCoverUrl());
    }
}

//多布局文件
private final class MultipleLayoutAdapter extends CommonRecyclerAdapter<News>{

    public MultipleLayoutAdapter(Context context, int layoutResId, List<News> data) {
        super(context, layoutResId, data);
    }

    @Override public void onCreate(RecyclerView.ViewHolder viewHolder, BaseAdapterHelper helper) {
        // ViewHolder 创建时回调
    }

    //多种布局重写此方法即可
    @Override public int getLayoutResId(News item, int position) {
        int layoutResId = -1;
        switch (item.getNewsType()){
            case News.TYPE_NONE_PICTURE: //布局样式一
                layoutResId = R.layout.item_none_picture;
                break;
            case News.TYPE_SINGLE_PICTURE: //布局样式二
                layoutResId = R.layout.item_single_picture;
                break;
            case News.TYPE_MULTIPLE_PICTURE: //布局样式三
                layoutResId = R.layout.item_multiple_picture;
                break;

            更多的布局样式 ...
        }
        return layoutResId;
    }

    @Override public void onUpdate(BaseAdapterHelper helper, News item, int position) {
        switch (item.getNewsType()){
            case News.TYPE_NONE_PICTURE: //布局样式一
                helper.setText(R.id.xxx, item.getTitle())
                      .setImageUrl(R.id.xxx,item.getCoverUrl());
                break;
            case News.TYPE_SINGLE_PICTURE: //布局样式二
                helper.setText(R.id.xxx, item.getTitle())
                      .setImageUrl(R.id.xxx,item.getCoverUrl());
                break;
            case News.TYPE_MULTIPLE_PICTURE: //布局样式三
                helper.setText(R.id.xxx, item.getTitle())
                      .setImageUrl(R.id.xxx,item.getCoverUrl());
                break;

            更多的布局样式 ...
        }
    }
}

RecyclerView 点击事件

commonRecyclerAdapter.setOnItemClickListener(this) // 设置 item 点击事件
                     .setOnItemLongClickListener(this) // 设置 item 长按事件
                     // 设置 Child view 的点击、长按、Touch 事件(方式一)
                     // OnChildViewClickListener 、 OnChildViewLongClickListener 、 OnChildViewTouchListener
                     .addChildViewListener(R.id.viewId, listener);

BaseAdapterHelper 使用示例

helper.setText(R.id.viewId, text)
      .setTag(R.id.viewId, objectTag)
      .setAlpha(R.id.viewId, 0.6f)
      .setBackgroundColor(R.id.viewId, R.color.colorResId)
      .setBackgroundRes(R.id.viewId, R.drawable.drawableResId)
      .setChecked(R.id.viewId, true)
      .setImageBitmap(R.id.viewId, bitmap)
      .setImageDrawable(R.id.viewId, drawable)
      .setImageResource(R.id.viewId, R.drawable.drawableResId)
      .setImageUrl(R.id.viewId, url)
      .setProgress(R.id.viewId, progress)
      .setProgress(R.id.viewId, progress, max)
      .setRating(R.id.viewId, rating)
      .setRating(R.id.viewId, rating, max)
      .setTextColor(R.id.viewId, R.color.colorResId)
      .setTextColorRes(R.id.viewId, R.color.colorResId)
      .setTextColorRes(R.id.viewId, R.color.colorResId, theme)
      //TextView 添加超链接,更多属性参考:android.text.util.Linkify#addLinks(TextView text, int mask)
      .addLinks(R.id.viewId, Linkify.ALL)
      //效果同上
      .addAllLinks(R.id.viewId)
      //单个 TextView 设置 Typeface
      .setTypeface(R.id.viewId, typeface)
      //多个 TextView 设置 Typeface
      .setTypeface(typeface, R.id.xxx1, R.id.xxx2, R.id.xxx3, ...)
      .setVisible(R.id.viewId, View.VISIBLE)
      //ProgressBar 设置 Max
      .setMax(R.id.viewId, max)
      //ListView、RecyclerView 设置 adapter
      .setAdapter(R.id.viewId, adapter)
      // 设置 Child view 的点击、长按、Touch 事件(方式二)
      .setOnTouchListener(R.id.viewId, onTouchListener)
      .setOnClickListener(R.id.viewId, onClickListener)
      .setOnLongClickListener(R.id.viewId, onLongClickListener)
      .setOnItemClickListener(R.id.viewId, onItemClickListener)
      .setOnItemLongClickListener(R.id.viewId, onItemLongClickListener)
      .setOnItemSelectedClickListener(R.id.viewId, onItemSelectedListener);

//获取 item 的 convertView
View convertView = helper.getView();

//如果上面的属性不够用,可以通过 getView(viewId)拿到 View,然后进行属性设置
View childView = helper.getView(R.id.viewId);

配置全局图片加载的实现类

public class YourApplication extends Application {

    @Override public void onCreate() {
        super.onCreate();

        ...

        ImageLoad imageLoadImpl = new GlideImageLoad();
        Adapter.config(new Adapter.Builder().setImageLoad(imageLoadImpl));
    }
}

自定义图片加载

public class YourXXX implements ImageLoad {

    @Override public void load(Context context, ImageView imageView, String imageUrl) {

        //使用 Glide 加载图片
        Glide.with(context).load(imageUrl).into(imageView);

        or

        //使用 Picasso 加载图片
        Picasso.with(context).load(url).into(imageView);

        or

        Fresco
        Android-Universal-Image-Loader
        自定义
        ...
    }
}

常用的数据操作

//CommonAdapter、CommonRecyclerAdapter 都实现了 IData 接口,里面包含了一些常用的数据操作

void add(T elem);

void addAll(List<T> elem);

void set(T oldElem, T newElem);

void set(int index, T elem);

void remove(T elem);

void remove(int index);

void replaceAll(List<T> elem);

boolean contains(T elem);

void clear();

感谢

base-adapter-helper

关于

License

Copyright 2015 classic

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
Apps
About Me
Google+: Trinea trinea
GitHub: Trinea