RecyclerView的基本用法
和百分比布局类似,RecyclerView也属于新增的控件,android团队也采取同样的方式,将RecyclerView定义在了support库当中。因此,想要用RecyclerView这个控件,首先需要在项目的build.gradle中添加相应的依赖库才行。打开app/build.gradle,在dependencies闭包中添加如下内容:
dependencies {
compile fileTree(dir:'libs',include: ['*.jar'])
androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
excludegroup:'com.android.support',module:'support-annotations'
})
compile'com.android.support:appcompat-v7:24.2.1'
compile'com.android.support:recyclerview-v7:24.2.1'
testCompile'junit:junit:4.12'
}
添加完后记得点击一下Sync Now来进行同步。然后修改activity_main.xml中的代码,如下所示:
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/activity_main"
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="match_parent"/>
</RelativeLayout>
先为RecyclerView指定一个id,然后将宽度和高度都设置为match_parent,这样RecyclerView也就占满了整个布局的空间。需要注意的是由于RecyclerView并不是内置在系统SDK当中,所以需要把完整的包路径写出来。
把之前用到的图片,item_fruit.xml和Fruit类都复制过来。然后为RecyclerView准备一个适配器,新建FruitAdapter类,让这个适配器继承自RecyclerView.Adapter,并将泛型指定为FruitAdapter.viewHolder。其中,ViewHolder使我们在FruitAdapter中定义一个内部类,代码如下:
public class FruitAdapterextends RecyclerView.Adapter {
private ListmFruitList;
static class ViewHolderextends RecyclerView.ViewHolder{
ImageViewfruitimage;
TextViewfruitname;
public ViewHolder(View view){
super(view);
fruitimage =(ImageView)view.findViewById(R.id.fruit_img);
fruitname =(TextView)view.findViewById(R.id.fruit_name);
}
}
public FruitAdapter(List fruitList){
mFruitList=fruitList;
}
@Override
public ViewHolderonCreateViewHolder(ViewGroup parent, int viewType) {
View view= LayoutInflater.from(parent.getContext()).inflate(R.layout.fruit_item,parent,false);
ViewHolder viewHolder=new ViewHolder(view);
return viewHolder;
}
@Override
public void onBindViewHolder(ViewHolder viewHolder,int position){
Fruit fruit=mFruitList.get(position);
viewHolder.fruitimage.setImageResource(fruit.getImageid());
viewHolder.fruitname.setText(fruit.getName());
}
@Override
public int getItemCount(){
return mFruitList.size();
}
}
看着很长,但是比ListView的适配器更容易理解。我们先定义了一个内部类ViewHolder,ViewHolder要继承自RecyclerView.ViewHolder。然后ViewHolder的构造函数中要传入一个View参数,这个参数通常是RecyclerView子项的最外层布局,那么我们可以通过findViewById()方法来获取到布局中的ImageView和TextView的实例了。
由于FruitAdapter是继承自RecyclerView.Adapter的,那么就必须重写onCreateViewHolder()、onBindViewHolder()和getItemCount()这三个方法。onCreateViewHolder()方法是用于创建ViewHolder实例的,我们在这个方法中将fruit_item布局加载进来,然后创建一个ViewHolder实例,并把加载出来的布局传入到构造函数当中,最后将ViewHolder的实例返回。onBindViewHolder()方法是用于对RecyclerView子项的数据进行赋值的,会在每个子项被滚动到屏幕内的时候执行,这里我们通过position参数得到当前项的Fruit实例,然后再将数据设置到ViewHolder的ImageView和TextView当中即可。getItemCount()方法就非常简单,它用于高速RecyclerView一共有多少子项,直接返回数据源的长度就可以了。
适配器准备好了,我们就可以开始RecyclerView,修改MainActivity中的代码,如下所示:
public class MainActivityextends AppCompatActivity {
private ListfruitList=new ArrayList<>();
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
//初始化水果数据
initFruits();
RecyclerView recyclerview=(RecyclerView)findViewById(R.id.recycler_view);
LinearLayoutManager lm=new LinearLayoutManager(this);
recyclerview.setLayoutManager(lm);
FruitAdapter adapter=new FruitAdapter(fruitList);
recyclerview.setAdapter(adapter);
}
private void initFruits() {
for(int i=0;i<2;i++){
Fruit apple =new Fruit("Apple",R.drawable.apple);
fruitList.add(apple);
Fruit banana=new Fruit("banana",R.drawable.banana);
fruitList.add(banana);
Fruit orange=new Fruit("orange",R.drawable.orange);
fruitList.add(orange);
Fruit water=new Fruit("watermelon",R.drawable.water);
fruitList.add(water);
Fruit pear=new Fruit("pear",R.drawable.pear);
fruitList.add(pear);
Fruit Str=new Fruit("Strawberry",R.drawable.stra);
fruitList.add(Str);
Fruit Cherry=new Fruit("Cherry",R.drawable.cherry);
fruitList.add(Cherry);
Fruit Mango=new Fruit("Mango",R.drawable.mango);
fruitList.add(Mango);
Fruit Grape=new Fruit("Grape",R.drawable.grape);
fruitList.add(Grape);
}
}
}
这里使用了一个同样的initFruits()方法,用于初始化所以得水果数据。接着在onCreate()方法中我们先获取到RecyclerView的实例,然后创建了一个LinearLayoutManager对象,并将它设置到RecyclerView当中。LayoutManager用于指定RecyclerView的布局方式,这里使用的LinearLayoutManager是线性布局的意思,可以实现和ListView类似的效果。接下来我们创建了FruitAdapter的实例,并将水果数据传入到FruitAdapter的构造函数中,最后调用RecyclerView的setAdapter()方法来完成适配器设置,这样RecyclerView和数据之间的关联就建立完成了。
现在运行以下程序,看看效果吧。
实现横向滚动和瀑布流布局
我们已经知道ListView的扩展性并不好,它只能实现纵向滚动效果,如果想进行横向滚动的话,ListView就做不到了。那么RecyclerView就能做得更好吗?当然可以,不仅能做得更好,还简单,那么我们先试试横向滚动吧。
首先修改fruit_item.xml中的代码,如下所示:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:orientation="vertical">
<ImageView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:id="@+id/fruit_img"
android:layout_gravity="center_horizontal"/>
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:id="@+id/fruit_name"
android:layout_gravity="center_horizontal"
android:layout_marginTop="10dp"/>
</LinearLayout>
我们将LinearLayout改成垂直方向排列。然后将ImageView和TextView都设置成了在布局中水平居中。并且使用layout_marginTop属性让文字和图片之间保持距离。
接下来修改MainActivity中的代码,如下所示:
public class MainActivityextends AppCompatActivity {
private ListfruitList=new ArrayList<>();
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
initFruits();
RecyclerView recyclerview=(RecyclerView)findViewById(R.id.recycler_view);
LinearLayoutManager lm=new LinearLayoutManager(this);
//调用LinearLayoutManager的setOrientation()方法来设置布局排列方式
lm.setOrientation(LinearLayoutManager.HORIZONTAL);
recyclerview.setLayoutManager(lm);
FruitAdapter adapter=new FruitAdapter(fruitList);
recyclerview.setAdapter(adapter);
}
private void initFruits() {
for(int i=0;i<2;i++){
Fruit apple =new Fruit("Apple",R.drawable.apple);
fruitList.add(apple);
Fruit banana=new Fruit("banana",R.drawable.banana);
fruitList.add(banana);
Fruit orange=new Fruit("orange",R.drawable.orange);
fruitList.add(orange);
Fruit water=new Fruit("watermelon",R.drawable.water);
fruitList.add(water);
Fruit pear=new Fruit("pear",R.drawable.pear);
fruitList.add(pear);
Fruit Str=new Fruit("Strawberry",R.drawable.stra);
fruitList.add(Str);
Fruit Cherry=new Fruit("Cherry",R.drawable.cherry);
fruitList.add(Cherry);
Fruit Mango=new Fruit("Mango",R.drawable.mango);
fruitList.add(Mango);
Fruit Grape=new Fruit("Grape",R.drawable.grape);
fruitList.add(Grape);
}
}
}
MainActivity中只加入了一行代码,调用LinearLayoutManager的setOrientation()方法来设置布局的排列方向,默认是纵向排列,传入LinearLayoutManager.HORIZONTAL表示让布局横向排列。
运行一下,看看效果图吧。
为什么ListView很难或者根本无法实现的效果在RecyclerView上这么轻松就能解决了呢?这主要得益于RecyclerView出色的设计。ListView的布局排列室友自身去管理的,而RecyclerView则将这个工作交给了LayoutManager,LayoutManager中制定了一套可扩展的布局排列接口,子类只要按照接口的规范来实现,就能制定出各种不同排列方式的布局了。
出了LinearLayoutManager之外,还提供了GridLayoutManager和StaggeredGridLayoutManager这两种内置的布局排列方式。GridLayoutManager可以用于实现网络布局,StaggeredGridLayoutManager可以用于实现瀑布流布局。我们来试一下效果炫酷的瀑布流布局,网格布局就作为练习吧,自己查阅相关资料。
要使用StaggeredGridLayoutManager实现瀑布流布局,首先修改fruit_item.xml中的代码,如图所示:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_margin="5dp"
android:orientation="vertical">
<ImageView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:id="@+id/fruit_img"
android:layout_gravity="center_horizontal"/>
<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>
至于上面的修改内容或添加的内容不在多做讲解,自己多花功夫去学习吧。
接下来,我们接着修改MainActivity中的代码,如下所示:
public class MainActivityextends AppCompatActivity {
private ListfruitList=new ArrayList<>();
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
//初始化水果数据
initFruits();
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 initFruits() {
for(int i=0;i<2;i++){
Fruit apple =new Fruit(getRandomLengthName("Apple"),R.drawable.apple);
fruitList.add(apple);
Fruit banana=new Fruit(getRandomLengthName("banana"),R.drawable.banana);
fruitList.add(banana);
Fruit orange=new Fruit(getRandomLengthName("orange"),R.drawable.orange);
fruitList.add(orange);
Fruit water=new Fruit(getRandomLengthName("watermelon"),R.drawable.water);
fruitList.add(water);
Fruit pear=new Fruit(getRandomLengthName("pear"),R.drawable.pear);
fruitList.add(pear);
Fruit Str=new Fruit(getRandomLengthName("Strawberry"),R.drawable.stra);
fruitList.add(Str);
Fruit Cherry=new Fruit(getRandomLengthName("Cherry"),R.drawable.cherry);
fruitList.add(Cherry);
Fruit Mango=new Fruit(getRandomLengthName("Mango"),R.drawable.mango);
fruitList.add(Mango);
Fruit Grape=new Fruit(getRandomLengthName("Grape"),R.drawable.grape);
fruitList.add(Grape);
}
}
private StringgetRandomLengthName(String name) {
Random randrom =new Random();
int length = randrom.nextInt(20)+1;
StringBuilder builder =new StringBuilder();
for(int i =0;i < length;i++){
builder.append(name);
}
return builder.toString();
}
}
在onCreate()方法中,我们创建了一个StaggeredGridLayoutManager的实例。StaggeredGridLayoutManager的构造函数接收两个参数,第一个参数用于指定布局的列数,传入3表示把布局分为3列;第二个参数用于指定布局的排列方式,传入StaggeredGridLayoutManager.VERTICAL表示让布局纵向排列,最后再把创建好的实例设置到RecyclerView中就可以了。
为了让瀑布流布局更加明显,我们使用了一个小技巧。这里我们看到getRandromLengthName()方法上,该方法使用了Random对象来创造一个1-20之间的随机数,然后将参数中传入的字符串随机重复,然后再initFruits()方法中,每种水果的名字都改成getRandromLengthName()来生成,保证每种水果名字的差距不太一样了,因此高度也就不同了。
现在运行一下,看看效果吧。
RecyclerView的点击事件
和ListView一样,RecyclerView也必须要能够响应点击事件才可以,不然没什么实际用途。不过不同于ListView的是,RecyclerView并没有提供类似于setOnItemClickListener()这样的注册监听器,而是需要我们自己给子项的具体的View去注册点击事件。相较于ListView要复杂。其实ListView点击事件的处理并不人性化,setOnItemClickListener()方法注册的是子项的点击事件,如果我想点击子项里的某一按键呢?虽然也能实现,但ListView就比RecyclerView麻烦。所以RecyclerView干脆直接摒弃了子项点击事件的监听器,所有的点击事件都由具体的View去注册,就在没有这个烦恼了。
下面我们进入正题吧,先修改FruitAdapter中的代码,如下所示:
public class FruitAdapterextends RecyclerView.Adapter {
private ListmFruitList;
static class ViewHolderextends RecyclerView.ViewHolder{
View fruitview;
ImageView fruitimage;
TextView fruitname;
public ViewHolder(View view){
super(view);
fruitview = view;
fruitimage =(ImageView)view.findViewById(R.id.fruit_img);
fruitname =(TextView)view.findViewById(R.id.fruit_name);
}
}
public FruitAdapter(List fruitList){
mFruitList=fruitList;
}
@Override
public ViewHolderonCreateViewHolder(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 v) {
int position =holder.getAdapterPosition();
Fruit fruit =mFruitList.get(position);
Toast.makeText(v.getContext(), "you clicked view "+fruit.getName(), Toast.LENGTH_SHORT).show();
}
});
return holder;
}
@Override
public void onBindViewHolder(ViewHolder viewHolder,int position){
Fruit fruit=mFruitList.get(position);
viewHolder.fruitimage.setImageResource(fruit.getImageid());
viewHolder.fruitname.setText(fruit.getName());
}
@Override
public int getItemCount(){
return mFruitList.size();
}
}
我们先是在ViewHolder中添加了fruitView变量来保存子项最外层布局的实例,然后在onCreateViewHolder()方法中注册点击事件就可以了。这里分为最外层布局和ImageView和TextView都注册了点击事件,RecyclerView的强大之处也在这里,它可以轻松实现子项中任意控件或布局的点击事件。点击事件都是先获取用户点击的position,然后通过position拿到相应的Fruit实例,在使用Toast分别弹出两种不同的内容以示区别。
运行一下吧,看看效果如何。