详解Android:利用RecyclerView及CardVie

作者: 醉破方知酒有权 | 来源:发表于2017-09-12 15:54 被阅读0次
    效果图

    本文的主要内容为:

    利用RecyclerView及CardView来创建卡片列表

    先贴出效果动图:


    安卓卡片布局.gif
    RecyclerView相当于一个更强大,更高效的ListView。但是由于RecyclerView姗姗来迟,在程序中应用RecyclerView组件时,必须要先在Android Studio 的build.gradle中添加对库的依赖,以达到兼容旧设备的目的。如下所示:
    图1:在Module:app中添加对v7库的支持

    同理,由于CardView也是后来才推出来的,因此应用时也应该添加依赖。这里一并演示,如图2:


    图2:添加依赖后对RecyclerView和CardView进行支持
    注:很多书上的写法与图2类似,但是“v7:”后面的数值往往不同,如果照做的话出错的概率还是非常大的。其实只要细心一点,观察build.gradle中默认存在的对appcompat进行支持的语句:
    compile 'com.android.support:appcompat-v7:26.+'
    

    就能推敲出来,其他的支持性语句怎么写。
    所以一个简单快捷而又不出错的添加库依赖的方法就是:复制上面那一条语句,然后把最关键的地方改动一下就OK了。

    也就是说:“support:”后面的单词就代表了对该组件的支持。

    所以要添加对RecyclerView的支持的话,将appcompat改成是recyclerview就可以了。CardView也同理。(注意大小写)

    添加了依赖之后,自然就是在布局文件中添加一个RecyclerView:

    <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        tools:context="com.example.chenlong.recyclerviewpluscardview.MainActivity">
    
        <android.support.v7.widget.RecyclerView
            android:id="@+id/card_list"
            android:layout_width="match_parent"
            android:layout_height="match_parent"/>
    </RelativeLayout>
    

    可以看到,添加的方法与添加系统的其他view如出一辙。

    那么接下来就需要在主活动当中获得这个组件:
    ...
    protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
    //获取RecyclerView的引用,并对其进行设置
            RecyclerView mRecyclerView = (RecyclerView) findViewById(R.id.card_list);
            mRecyclerView.setHasFixedSize(true);
    
    //RecyclerView 需要一个layoutManager,也就是布局管理器
    //布局管理器能确定RecyclerView内各个子视图(项目视图)的位置
    //并能决定何时重新使用对用户已不可见的项目视图
    //安卓为我们预先准备好了三种视图管理器:LinearLayoutManager、
    //GridLayoutManager、StaggeredGridLayoutManager(详见文档)
    
    //这里我们选择创建一个LinearLayoutManager
            LinearLayoutManager layoutManager = new LinearLayoutManager(this);
            layoutManager.setOrientation(LinearLayoutManager.VERTICAL);
    //为RecyclerView对象指定我们创建得到的layoutManager
            mRecyclerView.setLayoutManager(layoutManager);
    ...
    

    LinearLayoutManager顾名思义,就是以线性的方式来排列各个列表项。
    注意这里我们

    layoutManager.setOrientation(LinearLayoutManager.VERTICAL)
    

    指定了列表项是纵向排列的,也就是和ListView看起来是一样的。
    当然,我们同样可以指定其参数为

    layoutManager.setOrientation(LinearLayoutManager.HORIZONTAL)
    

    如此一来,RecyclerView的各个子项就会横向排布。
    而这一点是ListView所无能为力的。

    既然是要以列表的形式来显示项目,自然是少不了对列表项布局的设置了,下面就创建一个card_view.xml布局文件来对列表项的布局进行设置:
    <?xml version="1.0" encoding="utf-8"?>
    <android.support.v7.widget.CardView xmlns:android="http://schemas.android.com/apk/res/android"
       xmlns:app="http://schemas.android.com/apk/res-auto"
       android:id="@+id/view_card"
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       android:layout_marginBottom="20dp"
       android:elevation="4dp"
       android:orientation="vertical"
       app:cardCornerRadius="4dp">
    
       <RelativeLayout
           android:layout_width="match_parent"
           android:layout_height="match_parent"
           android:layout_marginBottom="10dp"
           android:layout_marginTop="10dp"
           android:alpha="0.8"
           android:background="#fafafa">
    
           <TextView
               android:id="@+id/title"
               android:layout_width="match_parent"
               android:layout_height="wrap_content"
               android:background="#eceff1"
               android:paddingLeft="5dp"
               android:text="contact information"
               android:textColor="#000000"
               android:textSize="20sp" />
    
           <TextView
               android:id="@+id/text_name"
               android:layout_width="wrap_content"
               android:layout_height="wrap_content"
               android:layout_below="@id/title"
               android:layout_marginLeft="5dp"
               android:layout_marginTop="10dp"
               android:gravity="center_vertical"
               android:padding="3dp"
               android:text="Name: "
               android:textColor="#2979ff"
               android:textSize="12sp" />
    
           <TextView
               android:id="@+id/text_surname"
               android:layout_width="wrap_content"
               android:layout_height="wrap_content"
               android:layout_below="@id/text_name"
               android:layout_marginLeft="5dp"
               android:layout_marginTop="10dp"
               android:padding="3dp"
               android:text="Surname: "
               android:textColor="#2979ff"
               android:textSize="12sp" />
    
           <TextView
               android:id="@+id/text_email"
               android:layout_width="wrap_content"
               android:layout_height="wrap_content"
               android:layout_alignBaseline="@id/text_name"
               android:layout_alignParentLeft="true"
               android:layout_marginLeft="170dp"
               android:padding="3dp"
               android:text="Email: "
               android:textColor="#2979ff"
               android:textSize="12sp" />
    
       </RelativeLayout>
    
    </android.support.v7.widget.CardView>
    

    可以看到这里我们用到了CardView。顾名思义也就是可以将内容以卡片的方式来呈现。并且可以设置卡片的圆角(cardCornerRadius)和仰角(elevation)参数。
    在CardView中有一个相对布局,其中包含了4个TextView。

    有了布局之后,得有与布局相对应的参数传入才可以啊。那么要怎么做呢?我们计划利用List类对泛型的支持来传入数据。

    所以我们需要先创建一个ContactInfo类:

    public class ContactInfo {
        protected String name = "小明";
        protected String surname = "西门";
        protected String email = "fever@icloud.com";
        protected static final String NAME_PREFIX = "Name_";
        protected static final String SURNAME_PREFIX = "Surname_";
        protected static final String EMAIL_PREFIX = "email_";
    
        public ContactInfo(String name, String surname, String email){
            this.name = name;
            this.surname = surname;
            this.email = email;
        }
    }
    

    这是个不能再简单的类了,里面只包含了构造方法和成员变量。

    现在我们有了数据(dataset),有了内含LinearLayoutManager对象的RecyclerView的对象,要怎样才能将数据传进去呢?答案就是:适配器。

    图3:Adapter的作用(图片引自https://developer.android.com/)
    所以下一步我们就需要创建一个适配器类。而且这个类需要继承自RecyclerView.Adapte:
    public class MyAdapter extends RecyclerView.Adapter<MyAdapter.ContactViewHolder> { 
    //重点:该泛型必须是 自定义的适配器(如MyAdapter).ViewHolder
    

    可以看到,这里MyAdapter需要一个ContactViewHolder对象。
    ViewHolder对象的存在,其实就是为了避免大量的findViewById方法浪费资源。
    其实写到这里,Android Studio就会提示创建一个ContactViewHolder类了:

    class ContactViewHolder extends RecyclerView.ViewHolder {
     //create the viewHolder class
            protected TextView vName;
            protected TextView vSurname;
            protected TextView vEmail;
            protected TextView vTitle;
    
            public ContactViewHolder(View itemView) {
                super(itemView);
                vName = itemView.findViewById(R.id.text_name);
                vSurname = itemView.findViewById(R.id.text_surname);
                vEmail = itemView.findViewById(R.id.text_email);
                vTitle = itemView.findViewById(R.id.title);
            }
    

    这里我们在MyAdapter中创建了一个内部类ContactViewHolder
    用意也就是创建一个ViewHolder然后hold(拿 | 保存)住所有定义了的view。

    接下来贴出整个MyAdapter类的代码:
    查看官方文档:

    图4:抽象类RecyclerView.Adapter

    既然是抽象类,我们继承时自然要重写抽象方法:

    1. onCreateViewHolder()
    2. onBindViewHolder()
    3. getItemCount()
    public class MyAdapter extends RecyclerView.Adapter
    <MyAdapter.ContactViewHolder> { //MyAdapter类 开始
    
    //MyAdapter的成员变量contactInfoList, 这里被我们用作数据的来源
        private List<ContactInfo> contactInfoList;
    
    //MyAdapter的构造器
        public MyAdapter(List<ContactInfo> contactInfoList) {
            this.contactInfoList = contactInfoList;
        }
    //重写3个抽象方法
    //onCreateViewHolder()方法 返回我们自定义的 ContactViewHolder对象
        @Override
        public ContactViewHolder onCreateViewHolder
    (ViewGroup parent, int viewType) {
            View itemView = LayoutInflater.from(parent.getContext()).
    inflate(R.layout.card_view,parent,false);
            return new ContactViewHolder(itemView);
        }
    
        @Override
        public void onBindViewHolder
    (ContactViewHolder holder, int position) {
    
    //contactInfoList中包含的都是ContactInfo类的对象
    //通过其get()方法可以获得其中的对象
            ContactInfo ci = contactInfoList.get(position);
    
    //将viewholder中hold住的各个view与数据源进行绑定(bind)
            holder.vName.setText(NAME_PREFIX+ci.name);
            holder.vSurname.setText(SURNAME_PREFIX+ci.surname);
            holder.vEmail.setText(EMAIL_PREFIX+ci.email);
            holder.vTitle.setText(ci.surname+ "" + ci.name);
        }
    
    //此方法返回列表项的数目
        @Override
        public int getItemCount() {
            return contactInfoList.size();
        }
    
        class ContactViewHolder extends RecyclerView.ViewHolder {
            //create the viewHolder class
    
            protected TextView vName;
            protected TextView vSurname;
            protected TextView vEmail;
            protected TextView vTitle;
    
            public ContactViewHolder(View itemView) {
                super(itemView);
                vName = itemView.findViewById(R.id.text_name);
                vSurname = itemView.findViewById(R.id.text_surname);
                vEmail = itemView.findViewById(R.id.text_email);
                vTitle = itemView.findViewById(R.id.title);
            }
    
        }
    } //结束 类MyAdapter
    

    注:

    图5:关于List类的get()方法 (图片源自官方文档)
    也就是说get()方法接收一个int类型的index,用于返回该index所指向的列表项。

    最后再在主活动中做一点收尾工作就可以了:

    public class MainActivity extends AppCompatActivity {
    
    //类成员
        private MyAdapter adapter;
        List<ContactInfo> mList = new ArrayList<>(); 
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
          
            RecyclerView mRecyclerView = (RecyclerView) findViewById(R.id.card_list);
            mRecyclerView.setHasFixedSize(true);
            LinearLayoutManager layoutManager = new LinearLayoutManager(this);
            layoutManager.setOrientation(LinearLayoutManager.VERTICAL);
            mRecyclerView.setLayoutManager(layoutManager);
    //初始化mList
            initInfo();
    //实例化MyAdapter并传入mList对象
            adapter = new MyAdapter(mList);
    //为RecyclerView对象mRecyclerView设置adapter
            mRecyclerView.setAdapter(adapter);
    
        }
    
        private void initInfo() {
    
    //        测试数据
            ContactInfo element1 = new ContactInfo("小明", "西门", "feverdg@icloud.com");
            mList.add(element1);
            ContactInfo element2 = new ContactInfo("小红", "南宫", "146793455@icloud.com");
            mList.add(element2);
            ContactInfo element3 = new ContactInfo("小九九", "欧阳", "17987453@icloud.com");
            mList.add(element3);
            ContactInfo element4 = new ContactInfo("小九九", "欧阳", "17987453@icloud.com");
            mList.add(element4);
            ContactInfo element5 = new ContactInfo("小九九", "欧阳", "17987453@icloud.com");
            mList.add(element5);
            ContactInfo element6 = new ContactInfo("小九九", "欧阳", "17987453@icloud.com");
            mList.add(element6);
            ContactInfo element7 = new ContactInfo("小明", "西门", "feverdg@icloud.com");
            mList.add(element7);
            ContactInfo element8 = new ContactInfo("小红", "南宫", "146793455@icloud.com");
            mList.add(element8);
            ContactInfo element9 = new ContactInfo("小九九", "欧阳", "17987453@icloud.com");
            mList.add(element9);
            ContactInfo element10 = new ContactInfo("小九九", "欧阳", "17987453@icloud.com");
            mList.add(element10);
            ContactInfo element11 = new ContactInfo("小九九", "欧阳", "17987453@icloud.com");
            mList.add(element11);
            ContactInfo element12 = new ContactInfo("小九九", "欧阳", "17987453@icloud.com");
            mList.add(element12);
        }
    }
    

    这样我们的小程序就大功告成了:)

    相关文章

      网友评论

        本文标题:详解Android:利用RecyclerView及CardVie

        本文链接:https://www.haomeiwen.com/subject/pwscsxtx.html