目录
- 一、简单介绍
- 1 什么是RecyclerView?
- 2 RecyclerView具有什么特点?
- 二 基本用法例子
- 1、实现和ListView一样的效果(垂直)
- 2.实现横向滚动布局
- 3.实现瀑布流布局
- 4.给RecyclerView添加点击事件
一、简单介绍
1 什么是RecyclerView?
A flexible view for providing a limited window into a large data set.
RecyclerView是根据数据集显示元素的滚动列表。
2 RecyclerView具有什么特点?
a. 优化了ListView
b. ViewHolder----把view封装起来
c. layoutmanager 布局管理器 控制Item的布局方式
d. ItemDecoration 设置Item的间隔样式
e. ItemAnimato 控制Item增删的动画
这里 d 和 e 这节课暂时还用不到,可以自己了解。
ItemDecoration 的用法ItemAnimato 的用法
ListView:布局比较单一,只有一个纵向效果。(如图)
RecyclerView :布局效果丰富, 可以在 LayoutMananger 中设置:线性布局(纵向,横向),表格布局,瀑布流布局。
二 基本用法例子
1、实现和ListView一样的效果(垂直)
实现和ListView一样的效果,垂直摆放图片:
步骤:
(1)添加依赖库:
打开app/build.gradle文件,在dependencies闭包中添加如下内容:
implementation “androidx.recyclerview:recyclerview:1.1.0”
《第一行代码》里面用的是下面这个依赖包,但是在我这会报错,大家可以检查一下自己的版本,看具体情况修改。
implementation ‘com.android.support:recyclerview-v7:24.2.1’
看一下:
记得点sync now。
(2)在activity_main.xml布局文件加入RecyclerView控件:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<androidx.recyclerview.widget.RecyclerView
android:id="@+id/recycler_view"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
</LinearLayout>
(3)新建Fruit类
public class Fruit {
private String name;
private int imageId;
public Fruit(String name, int imageId){
this.name = name;
this.imageId = imageId;
}
public String getName(){
return name;
}
public int getImageId(){
return imageId;
}
}
(4)新建fruit_item.xml文件
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<ImageView
android:id="@+id/fruit_image"
android:layout_width="100dp"
android:layout_height="100dp"/>
<TextView
android:id="@+id/fruit_name"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="center_vertical"
android:layout_marginLeft="10dp"/>
</LinearLayout>
(5)修改MainActivity.java里面的代码(别忘了添加图片文件到drawable里面)
public class MainActivity extends AppCompatActivity {
private List<Fruit> fruitList = new ArrayList<>();
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
initFruit();//初始化水果数据
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler_view);
LinearLayoutManager layoutManager = new LinearLayoutManager(this);
recyclerView.setLayoutManager(layoutManager);
FruitAdapter adapter = new FruitAdapter(fruitList);
recyclerView.setAdapter(adapter);
}
private void initFruit(){
for(int i=0 ; i<2 ; i++){
Fruit apple = new Fruit("Apple",R.drawable.apple_pic);
fruitList.add(apple);
Fruit banana = new Fruit("Banana",R.drawable.banana_pic);
fruitList.add(banana);
Fruit orange = new Fruit("Orange",R.drawable.orange_pic);
fruitList.add(orange);
Fruit grape = new Fruit("Grape",R.drawable.grape_pic);
fruitList.add(grape);
Fruit pineapple = new Fruit("Pineapple",R.drawable.pineapple_pic);
fruitList.add(pineapple);
}
}
}
到这里就完成啦,跑一下虚拟机看一下效果吧!!
2.实现横向滚动布局
步骤:
(1)对fruit_item.xml的代码进行修改:添加orientation,修改布局的width,将各个控件调整为水平居中,再使用marginTop使文字和图片之间保持一些距离。
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="120dp"
android:layout_height="wrap_content">
<ImageView
android:id="@+id/fruit_image"
android:layout_width="100dp"
android:layout_height="100dp"
android:layout_gravity="center_horizontal"/>
<TextView
android:id="@+id/fruit_name"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="center_vertical"
android:layout_marginLeft="10dp"
android:gravity="center_horizontal"
android:layout_marginTop="10dp"/>
</LinearLayout>
(2)修改MainActivity.java里面的代码,在onCreate方法里面添加一行代码,设置方向。
layoutManager.setOrientation(LinearLayoutManager.HORIZONTAL);
再运行一下虚拟机,左右滑动页面看一下效果吧。
3.实现瀑布流布局
(1)对fruit_item.xml的代码进行修改:因为瀑布流布局的宽度是根据布局的列数自动适配的,不是一个固定值,将宽度改为match_parent。layout_margin属性让子项之间留出间距。TextView改为居左对齐,如果文字的长度变长,显示出来才不会奇怪。
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_margin="5dp"
>
<ImageView
android:id="@+id/fruit_image"
android:layout_width="100dp"
android:layout_height="100dp"
android:layout_gravity="center_horizontal"/>
<TextView
android:id="@+id/fruit_name"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="left"
android:layout_marginLeft="10dp"
android:gravity="center_horizontal"
android:layout_marginTop="10dp"/>
</LinearLayout>
(2)修改MainActivity.java里面的代码:
- 在 onCreate 方法里面删去原来的线性布局,然后创建 StaggerGridLayoutManager 的实例,其构造函数接收两个参数,一个是指定布局的列数(这里传入3列),一个是指定布局的排列方向。
- 为了让瀑布流的效果更加明显,我们调整一下每一个子项的高度,使他们高度不一致,添加 getRandomLengthName() 方法,创建随机数控制高度。
public class MainActivity extends AppCompatActivity {
private List<Fruit> fruitList = new ArrayList<>();
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
initFruit();//初始化水果数据
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler_view);
StaggeredGridLayoutManager layoutManager = new StaggeredGridLayoutManager(3,StaggeredGridLayoutManager.VERTICAL);
recyclerView.setLayoutManager(layoutManager);
FruitAdapter adapter = new FruitAdapter(fruitList);
recyclerView.setAdapter(adapter);
}
private void initFruit() {
for (int i = 0; i < 2; i++) {
Fruit apple = new Fruit(getRandomLengthName("Apple"), R.drawable.apple_pic);
fruitList.add(apple);
Fruit banana = new Fruit(getRandomLengthName("Banana"), R.drawable.banana_pic);
fruitList.add(banana);
Fruit orange = new Fruit(getRandomLengthName("Orange"), R.drawable.orange_pic);
fruitList.add(orange);
Fruit grape = new Fruit(getRandomLengthName("Grape"), R.drawable.grape_pic);
fruitList.add(grape);
Fruit pineapple = new Fruit(getRandomLengthName("Pineapple"), R.drawable.pineapple_pic);
fruitList.add(pineapple);
}
}
private String getRandomLengthName(String name){
Random random = new Random();
int length = random.nextInt(20)+1;
StringBuilder builder = new StringBuilder();
for(int i=0;i<length;i++){
builder.append(name);
}
return builder.toString();
}
}
4.给RecyclerView添加点击事件
(1)修改FruitAdapter中的代码:定义View fruitView,在 ViewHolder 里面添加 fruitView 变量来保持子项最外层布局的实例,然后再 onCreateViewHolder() 方法中注册点击事件。在两个点击事件中先获得了用户点击的 position,然后通过 position 获得 Fruit 实例,再使用 Toast 提示。
public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> {
private List<Fruit> mFruitList;
//创建ViewHolder实例,将fruit_item.xml的布局加载进来,并且将布局传入到构造函数中
@NonNull
@Override
public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.fruit_item,parent,false);
final ViewHolder holder = new ViewHolder(view);
holder.fruitView.setOnClickListener(new View.OnClickListener(){
@Override
public void onClick(View v){
int position = holder.getAdapterPosition();
Fruit fruit = mFruitList.get(position);
Toast.makeText(v.getContext(),"you clicked view"+fruit.getName(),Toast.LENGTH_SHORT).show();;
}
});
holder.fruitImage.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
int position = holder.getAdapterPosition();
Fruit fruit = mFruitList.get(position);
Toast.makeText(view.getContext(),"you clicked image "+fruit.getName(),Toast.LENGTH_SHORT).show();
}
});
return holder;
}
//给RecyclerView的子项赋值,会在子项被滚动到屏幕内的时候执行
@Override
public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
Fruit fruit = mFruitList.get(position);
holder.fruitImage.setImageResource(fruit.getImageId());
holder.fruitName.setText(fruit.getName());
}
//返回RecyclerView的子项数目
@Override
public int getItemCount() {
return mFruitList.size();
}
static class ViewHolder extends RecyclerView.ViewHolder{
ImageView fruitImage;
TextView fruitName;
View fruitView;
public ViewHolder(View view) {
super(view);
fruitView = view;
fruitImage = (ImageView) view.findViewById(R.id.fruit_image);
fruitName = (TextView) view.findViewById(R.id.fruit_name);
}
}
//这是一个构造函数,将传过来的数据源赋值给mFruitList
public FruitAdapter(List<Fruit> fruitList){
mFruitList = fruitList;
}
}
跑一下看一下效果吧!