Android的RecyclerView使用总结

2024-05-19 09:38

本文主要是介绍Android的RecyclerView使用总结,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

前言:

RecyclerView 小组件比 ListView 更高级且更具灵活性。 此小组件是一个用于显示庞大数据集的容器,可通过保持有限数量的视图进行非常有效的滚动操作。 如果您有数据集合,其中的元素将因用户操作或网络事件而发生改变,请使用RecyclerView 小组件。

RecyclerView  类别将通过提供下列功能简化庞大数据集的显示与处理:
用于项目定位的布局管理器
用于通用项目操作(例如删除或添加项目)的默认动画
您也可灵活选择如何为 RecyclerView 小组件定义定制布局管理器与动画。


如果要使用 RecyclerView  小组件,您必须指定一个适配器和一个布局管理器。 如果要创建一个适配器,请扩展 RecyclerView.Adapter  类别。

实现的详情将取决于数据集的具体信息以及视图的类型。 如果要了解更多信息,请参阅下列示例。

布局管理器将确定RecyclerView 内各项目视图的位置并决定何时重新使用用户已不可见的项目视图。 如果要重新使用(或重复使用)一个视图,布局管理器可能会要求适配器以数据集中的另一个元素替换视图的内容。 以此方式重复使用视图将可避免创建不必要的视图或执行成本高昂的 findViewById() 查找,从而改善性能。


RecyclerView  提供这些内置布局管理器:
LinearLayoutManager 以垂直或水平滚动列表方式显示项目。
GridLayoutManager 在网格中显示项目。
StaggeredGridLayoutManager 在分散对齐网格中显示项目。
如果要创建一个定制布局管理器,请扩展 RecyclerView.LayoutManager  类别。


动画
RecyclerView 在默认情况下启用增添与删除项目的动画。如果要定制这些动画,请扩展RecyclerView.ItemAnimator类别

并使用  RecyclerView.setItemAnimator()方法。


添加依赖项

RecyclerView小组件为 v7 支持内容库的一部分。 如果要在您的项目中使用这些小组件,请将 Gradle 依赖项添加至您的应用模块:

dependencies {...compile 'com.android.support:recyclerview-v7:21.0.+'
}


效果图:



RecyclerView解析

解析一:RecyclerView的基本使用(数据正常显示)

步骤一:编写布局(可以和listView对比来用)

<android.support.v7.widget.RecyclerView
    android:layout_width="match_parent"
    android:layout_height="0dp"
    android:layout_weight="8"
    android:id="@+id/rv"
    >
</android.support.v7.widget.RecyclerView>

步骤二:编写适配器

1>适配器需要继承RecyclerView.Adapter<MyAdapter.ViewHolder>

2>重写RecyclerView.Adapter<MyAdapter.ViewHolder>里边的三个方法:

onCreateViewHolder(ViewGroup parent, int viewType)
public void onBindViewHolder(final ViewHolder holder, int position)
public int getItemCount()

public class MyAdapter extends RecyclerView.Adapter<MyAdapter.ViewHolder> {/***
     *所要展示的数据
     */
    private List<String> mDataset;

    /**
     * 构造函数
     * @param myDataset
     */
    public MyAdapter(List<String> myDataset) {mDataset = myDataset;
    }/**
     * 用于将布局载入ViewHolder里,实例化ViewHolder,并返回ViewHolder实例
     * @param parent
     * @param viewType
     * @return
     */
    @Override
    public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {View v = LayoutInflater.from(parent.getContext()).inflate(R.layout.recyclerview_item_layout,parent,false);
        ViewHolder mViewHolder = new ViewHolder(v);
        return mViewHolder;
    }/**
     * 初始化子条目里边的控件
     * @param holder
     * @param position
     */
    @Override
    public void onBindViewHolder(final ViewHolder holder, int position) {holder.mTextView.setText(mDataset.get(position));
        if(listener != null){holder.mTextView.setOnClickListener(new View.OnClickListener() {@Override
                public void onClick(View v) {listener.onItemClick(v);
                }});

        }}/***
     * getItemCount()listView里边的getItemCount()方法所起作用一致,
     * 都是得到Adapter中所有条目的总数
     * @return
     */
    @Override
    public int getItemCount() {return mDataset.size();
    }/**
     * ViewHolder继承于RecyclerView.ViewHolder     * 然后在ViewHolder里边保存子条目的控件
     */
    class ViewHolder extends RecyclerView.ViewHolder{public TextView mTextView;
        public ViewHolder(View v) {super(v);
            mTextView = (TextView) v.findViewById(R.id.tv);
        }}}

步骤三:初始化数据和控件

主要是设置RecyclerView的适配器以及布局管理器

@Override
protected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    initData();

    initView();

}
/**
 * 构建数据
 */
private void initData() {mCityList.add("广州");
    mCityList.add("北京");
    mCityList.add("深圳");
    mCityList.add("上海");
    mCityList.add("杭州");
    mCityList.add("武汉");
    mCityList.add("天津");
    mCityList.add("重庆");
    mCityList.add("厦门");
    mCityList.add("香港");
    mCityList.add("福州");
    mCityList.add("南京");
    mCityList.add("苏州");
    mCityList.add("黄石");
    mCityList.add("大连");
    mCityList.add("丽江");
    mCityList.add("青岛");
    mCityList.add("重庆");
    mCityList.add("扬州");
    mCityList.add("澳门");
}
/**
 * 初始化控件
 */
public void initView(){mRecyclerView = (RecyclerView) findViewById(R.id.rv);

    /**
     * 指定一个布局管理器,在这里指定为LinearLayoutManager     * 若没有设置其排放的位置,则默认为竖直排放
     */
    mLayoutManager = new LinearLayoutManager(this);
    mRecyclerView.setLayoutManager(mLayoutManager);


    /**
     * 获取适配器
     */
    mAdapter = new MyAdapter(mCityList);

    /**
     * 设置RecyclerView的适配器
     */
    mRecyclerView.setAdapter(mAdapter);

}


解析二:布局管理器和动画

通过设置布局管理器,可以实现不同的展示效果,例如实现ListView的效果,GridView的效果,还有另外一种效果(自行体会)。

在代码的初始部分,布局管理器是需要进行设置的,否则,数据是不会显示出来的。例如:

/**
 * 指定一个布局管理器,在这里指定为LinearLayoutManager * 若没有设置其排放的位置,则默认为竖直排放
 */
mLayoutManager = new LinearLayoutManager(this);
mRecyclerView.setLayoutManager(mLayoutManager);


动画,主要是用在在删除条目或增加条目时,产生动画的效果,在代码中,不设置,则会使用系统默认的一种效果显示出来。

当然这个动画也可以自行去定义一个。但是在增删时,若想要看到动画效果,那么在添加数据时,需要用mAdapter.notifyItemInserted(index)

来替代mAdapter.notifyDataSetChanged()方法,在删除数据时,需要用mAdapter.notifyItemRemoved(index);来替代mAdapter.notifyDataSetChanged()

方法。例如:

/**
 * 设置动画,这里采用的是默认的一个动画,
 * 若不设置,也会使用这个默认的动画,当然也可以自行去定义动画。
 */
mRecyclerView.setItemAnimator(new DefaultItemAnimator());


解析三:分割线解析

分割线的实现,如下代码所示:

/**
 * 设置分割线
 */
mItemDecoration = new DividerItemDecoration(this, mCurrentOrientation);
mRecyclerView.addItemDecoration(mItemDecoration);

在这里,DividerItemDecoration类是需要我们自己去实现,它继承于RecyclerView.ItemDecoration,所以需要重写

其里边的方法,如下(参考官网Sample):

onDraw()主要用来实现分割线的绘制

@Override
public void onDraw(Canvas c, RecyclerView parent) {if (mOrientation == VERTICAL_LIST) {drawVertical(c, parent);
    } else {drawHorizontal(c, parent);
    }
}

getItemOffsets()主要是用来给绘制的分割线留出空间,

当然,也可以实现让 Item 与 其余 Item之间产生一定的间隔

@Override
public void getItemOffsets(Rect outRect, int itemPosition, RecyclerView parent) {int margin = (int) dimens*1;

    if (mOrientation == VERTICAL_LIST) {/**
         * Set the rectangle's coordinates to the specified values. Note: no range
         * checking is performed, so it is up to the caller to ensure that
         * left <= right and top <= bottom.
         *
         * @param left   The X coordinate of the left side of the rectangle
         * @param top    The Y coordinate of the top of the rectangle
         * @param right  The X coordinate of the right side of the rectangle
         * @param bottom The Y coordinate of the bottom of the rectangle
         */
        /**
         * 其实这一部分和设置Itemmargin效果一样,
         * 源码里边会把这一部分空间当做是系统已占用的空间,所以在绘制Item时,
         * 这一部分的是不会再被Item所利用的,而是空出来,由于分割线的绘制早于
         * Item的绘制,所以我们可以通过空出这么一部分信息,从而让分割线绘制的
         * 部分不被其余Item所占用。
         *
         * 在本示例中,我在布局文件中,把Itemmargin设置了 1dp ,
         * 而分割线是在Itemmargin下边绘制的,所以在本示例中,
         * 分割线会距离上边的Item 1dp 的间隔,与此同时,又由于分割线的高度为 4dp         * 所以在outRect.set(0, 0, 0, mDivider.getIntrinsicHeight() + margin)函数中,
         * 我通过也空出了分割线的高度 4dp ,然后还空出一个 1dp (int margin = (int) dimens*1;)         * 这样大家就可以观察到 在分割线的上方和下方,都会有一个 1dp 的空白间隔,这也就是
         * outRect.set(0, 0, 0, mDivider.getIntrinsicHeight() + margin)函数所起的作用,
         * 若将这个函数的参数全部设置为0,那么,Item是会覆盖掉分割线的,因为 Item的绘制晚于分割线的绘制;
         */
        outRect.set(0, 0, 0, mDivider.getIntrinsicHeight() + margin);
    } else {outRect.set(0, 0, mDivider.getIntrinsicHeight() + margin, 0);
    }
}

解析四:条目的侦听

在RecyclerView中,其是没有对 Item 的侦听的,所以需要我们自己用接口去实现,示例如下:

1>创建侦听接口用来给用户予以回调
public interface OnItemClickListen{void onItemClick(View v);
}

2>创建设置侦听接口的方法
public void setListener(OnItemClickListen listener){this.listener = listener;
}

3>当点击时,在里边调用侦听接口的方法
public void onBindViewHolder(final ViewHolder holder, int position) {holder.mTextView.setText(mDataset.get(position));
    if(listener != null){holder.mTextView.setOnClickListener(new View.OnClickListener() {@Override
            public void onClick(View v) {listener.onItemClick(v);
            }});

    }
}

4>若用户想要对 Item进行侦听,则需设置 侦听者(这个由调用者来实现)
/**
 * 自定义条目的侦听,因为默认情况下,
 * RecyclerView是没有对条目侦听的API的,
 * 需要自己去予以实现...
 */
mAdapter.setListener(new MyAdapter.OnItemClickListen(){@Override
    public void onItemClick(View v) {Toast.makeText(MainActivity.this,((TextView) v).getText(),Toast.LENGTH_SHORT).show();
    }
});


参考:

RecyclerView Training

RecyclerView API

深入理解 RecyclerView 系列之一:ItemDecoration


源码:

RecyclerView使用总结示例源码

这篇关于Android的RecyclerView使用总结的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/995778

相关文章

Java使用SLF4J记录不同级别日志的示例详解

《Java使用SLF4J记录不同级别日志的示例详解》SLF4J是一个简单的日志门面,它允许在运行时选择不同的日志实现,这篇文章主要为大家详细介绍了如何使用SLF4J记录不同级别日志,感兴趣的可以了解下... 目录一、SLF4J简介二、添加依赖三、配置Logback四、记录不同级别的日志五、总结一、SLF4J

使用Python实现一个优雅的异步定时器

《使用Python实现一个优雅的异步定时器》在Python中实现定时器功能是一个常见需求,尤其是在需要周期性执行任务的场景下,本文给大家介绍了基于asyncio和threading模块,可扩展的异步定... 目录需求背景代码1. 单例事件循环的实现2. 事件循环的运行与关闭3. 定时器核心逻辑4. 启动与停

如何使用Nginx配置将80端口重定向到443端口

《如何使用Nginx配置将80端口重定向到443端口》这篇文章主要为大家详细介绍了如何将Nginx配置为将HTTP(80端口)请求重定向到HTTPS(443端口),文中的示例代码讲解详细,有需要的小伙... 目录1. 创建或编辑Nginx配置文件2. 配置HTTP重定向到HTTPS3. 配置HTTPS服务器

Java使用ANTLR4对Lua脚本语法校验详解

《Java使用ANTLR4对Lua脚本语法校验详解》ANTLR是一个强大的解析器生成器,用于读取、处理、执行或翻译结构化文本或二进制文件,下面就跟随小编一起看看Java如何使用ANTLR4对Lua脚本... 目录什么是ANTLR?第一个例子ANTLR4 的工作流程Lua脚本语法校验准备一个Lua Gramm

Java Optional的使用技巧与最佳实践

《JavaOptional的使用技巧与最佳实践》在Java中,Optional是用于优雅处理null的容器类,其核心目标是显式提醒开发者处理空值场景,避免NullPointerExce... 目录一、Optional 的核心用途二、使用技巧与最佳实践三、常见误区与反模式四、替代方案与扩展五、总结在 Java

Android Mainline基础简介

《AndroidMainline基础简介》AndroidMainline是通过模块化更新Android核心组件的框架,可能提高安全性,本文给大家介绍AndroidMainline基础简介,感兴趣的朋... 目录关键要点什么是 android Mainline?Android Mainline 的工作原理关键

使用Java将DOCX文档解析为Markdown文档的代码实现

《使用Java将DOCX文档解析为Markdown文档的代码实现》在现代文档处理中,Markdown(MD)因其简洁的语法和良好的可读性,逐渐成为开发者、技术写作者和内容创作者的首选格式,然而,许多文... 目录引言1. 工具和库介绍2. 安装依赖库3. 使用Apache POI解析DOCX文档4. 将解析

Qt中QUndoView控件的具体使用

《Qt中QUndoView控件的具体使用》QUndoView是Qt框架中用于可视化显示QUndoStack内容的控件,本文主要介绍了Qt中QUndoView控件的具体使用,具有一定的参考价值,感兴趣的... 目录引言一、QUndoView 的用途二、工作原理三、 如何与 QUnDOStack 配合使用四、自

C++使用printf语句实现进制转换的示例代码

《C++使用printf语句实现进制转换的示例代码》在C语言中,printf函数可以直接实现部分进制转换功能,通过格式说明符(formatspecifier)快速输出不同进制的数值,下面给大家分享C+... 目录一、printf 原生支持的进制转换1. 十进制、八进制、十六进制转换2. 显示进制前缀3. 指

如何解决idea的Module:‘:app‘platform‘android-32‘not found.问题

《如何解决idea的Module:‘:app‘platform‘android-32‘notfound.问题》:本文主要介绍如何解决idea的Module:‘:app‘platform‘andr... 目录idea的Module:‘:app‘pwww.chinasem.cnlatform‘android-32