Android笔记006—RecyclerView控件（瀑布流）

RecyclerView

实现横向滚动和瀑布流

用法

1.新建项目

修改activity_main.xml中的代码

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout 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">

<!-- 为RecyclerView指定一个id，然后将宽度和 高度都设置为match_parent ，这样RecyclerView也就占满了整个布局的空间。
      只能控制自己（RecyclerView）的布局，对于以后动态加载的的子项没有控制能力-->
    <androidx.recyclerview.widget.RecyclerView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:id="@+id/recycler_view"/>

</androidx.constraintlayout.widget.ConstraintLayout>

2.添加类Fruit 类和fruit_item.xml

Fruit 类存储数据用。相当于C语言的结构体

package com.example.recyclerview;

import androidx.annotation.NonNull;

public class Fruit {
    private String name;
    private int imageId;

    public Fruit(String name1,int imageId1){
        this.name = name1;
        this.imageId = imageId1;
    }
    public String getName(){
        return name;
    }
    public int getImageId(){
        return imageId;
    }

    @NonNull
    @Override
    public String toString() {
        return "Fruit{" +
                "name='" + name + '\'' +
                ", imageId=" + imageId +
                '}';
    }
}

fruit_item.xml，在这里完成子项的布局。

<?xml version="1.0" encoding="utf-8"?>
<!--竖直
    android:layout_width="match_parent"
    android:layout_height="wrap_content"-->
<!--水平
    android:orientation="vertical"
    android:layout_width="100dp"
    android:layout_height="wrap_content"
-->
<!--这里是每一个子项的布局控制，也只能控制每一个子项的-->
<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">
<!--水平加
android:layout_gravity="center_horizontal"-->
    <ImageView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:id="@+id/fruit_image"
        />
<!--竖直是
    android:layout_marginLeft="10dp"
    竖直和水平
    android:layout_gravity="center_vertical"
    -->
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:id="@+id/fruit_name"
        android:layout_gravity="left"
        android:layout_marginTop="10dp"
        />

</LinearLayout>

3.自定义适配器

新建FruitAdapter 类
这里实现了数据的适配，数据先从FruitAdapter 的构造函数传入进来，保存到全局变量 mFruitList。
然后依次执行onCreateViewHolder() 、onBindViewHolder() 和getItemCount() 这3个方法。
onCreateViewHolder()中将fruit_item 布局加载进来，然后创建一个ViewHolder 实例。点击事件的注册也在这里。
onBindViewHolder() 方法是用于对 RecyclerView子项的数据进行赋值。
getItemCount() 方法告诉RecyclerView一共有多少子项。

package com.example.recyclerview;
//自定义适配器
import android.provider.ContactsContract;
import android.util.Log;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.ImageView;
import android.widget.LinearLayout;
import android.widget.TextView;
import android.widget.Toast;

import androidx.annotation.NonNull;
import androidx.recyclerview.widget.RecyclerView;

import java.util.List;

public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> {

    private List<Fruit> mFruitList;
    //定义了一个内部类ViewHolder ，ViewHolder 继承自RecyclerView.ViewHolder 。
    static class ViewHolder extends RecyclerView.ViewHolder{
        //fruitview保存子项最外层 布局的实例
        View fruitview;
        ImageView fruitImage;
        TextView fruitName;
        //构造函数中要传入一个View 参数，这个参数是RecyclerView子项的最外层布局（这里是fruit_item.xml）
        // 我们就可以通过findViewById() 方法来获取到布局中的ImageView和 TextView的实例。
        public ViewHolder(@NonNull View itemView) {
            super(itemView);
            fruitview = itemView;
            fruitImage = (ImageView) itemView.findViewById(R.id.fruit_image);
            fruitName = (TextView) itemView.findViewById(R.id.fruit_name);
        }
    }
    //FruitAdapter 的构造函数，这个方法用于把要展示的数据源传进来， 并赋值给一个全局变量mFruitList
    public FruitAdapter(List<Fruit> fruitList){
        mFruitList = fruitList;
    }
    //FruitAdapter 是继承自RecyclerView.Adapter 的么就必须重写 onCreateViewHolder() 、onBindViewHolder() 和getItemCount() 这3个方 法。

    //onCreateViewHolder() 方法是用于创建ViewHolder 实例。
    // 在这个方法中 将fruit_item 布局加载进来，然后创建一个ViewHolder 实例，
    // 并把加载出来的布局传入到构造函数ViewHolder（）（就在上面）当中，最后将ViewHolder 的实例返回。
    @NonNull
    @Override
    public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.fruit_item,parent,false);
        ViewHolder holder = new ViewHolder(view);
        Log.d("fruit01", "onCreateViewHolder0000: "+parent.getContext());
        Log.d("fruit01", "onCreateViewHolder1111: "+parent);
        //注册点击事件
        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 v) {
                int position = holder.getAdapterPosition();
                Fruit fruit = mFruitList.get(position);
                Toast.makeText(v.getContext(), "you clicked image " + fruit.getName(), Toast.LENGTH_SHORT).show();

            }
        });

        return holder;
    }
    //onBindViewHolder() 方法是用于对 RecyclerView子项的数据进行赋值的，会在每个子项被滚动到屏幕内的时候执行，
    // 这里通过 position 参数得到当前项的Fruit 实例，然后再将数据设置到ViewHolder 的ImageView和 TextView当中即可。
    @Override
    public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
        Fruit fruit = mFruitList.get(position);
        holder.fruitImage.setImageResource(fruit.getImageId());
        holder.fruitName.setText(fruit.getName());

    }
    //getItemCount() 方法，它用于告诉RecyclerView一共有多少子项，直接返回数据源的长度就可以。
    @Override
    public int getItemCount() {
        return mFruitList.size();
    }
}

4.修改MainActivity中的代码

package com.example.recyclerview;

import androidx.appcompat.app.AppCompatActivity;
import androidx.recyclerview.widget.LinearLayoutManager;
import androidx.recyclerview.widget.RecyclerView;
import androidx.recyclerview.widget.StaggeredGridLayoutManager;

import android.os.Bundle;

import java.util.ArrayList;
import java.util.List;

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);
        initFruits();
        //获取到RecyclerView的实例，然后创建了一个LinearLayoutManager 对象，并将它设置到RecyclerView当中。
        RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler_view);

//        水平和竖直
//        LinearLayoutManager layoutManager = new LinearLayoutManager(this);
//        //LayoutManager用于指定 RecyclerView的布局方式，这里使用的LinearLayoutManager是线性布局的意思，
//        // recyclerView.setLayoutManager(layoutManager);可以实现和 ListView类似的效果。
//       //调用LinearLayoutManager的setOrientation() 方法来设置布局的排列方向，默认是纵向排列的，
//        // 我们传入LinearLayoutManager.HORIZONTAL 表 示让布局横行排列，加了这一行就是水平滑动
//        layoutManager.setOrientation(LinearLayoutManager.HORIZONTAL);
//        recyclerView.setLayoutManager(layoutManager);
        //瀑布流
        StaggeredGridLayoutManager layoutManager = new StaggeredGridLayoutManager(3,StaggeredGridLayoutManager.VERTICAL);
        recyclerView.setLayoutManager(layoutManager);

        //创建了FruitAdapter 的实例，并将水果数据传入 到FruitAdapter 的构造函数中，
        // 最后调用RecyclerView的setAdapter() 方法来完成适配器设置，
        FruitAdapter adapter = new FruitAdapter(fruitList);
        recyclerView.setAdapter(adapter);

    }
    private void initFruits(){
        for (int i = 0; i<3 ; 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 watermelon = new Fruit("Watermelon", R.drawable.watermelon_pic);
            fruitList.add(watermelon);
            Fruit pear = new Fruit("Pear", R.drawable.pear_pic);
            fruitList.add(pear);
            Fruit grape = new Fruit("Grape", R.drawable.grape_pic);
            fruitList.add(grape);
            Fruit pineapple = new Fruit("Pineapple", R.drawable.pineapple_pic);
            fruitList.add(pineapple);
            Fruit strawberry = new Fruit("Strawberry", R.drawable.strawberry_pic);
            fruitList.add(strawberry);
            Fruit cherry = new Fruit("Cherry", R.drawable.cherry_pic);
            fruitList.add(cherry);
            Fruit mango = new Fruit("Mango", R.drawable.mango_pic);
            fruitList.add(mango);

        }
    }
}