关于ListView的总结

关于ListView网上也有许多的介绍,我选了一些结合到了一起,仅供参考。

在android开发中ListView是比较常用的组件 

官方API地址:http://www.android-doc.com/reference/android/widget/ListView.html

1.ListVeiw 用来展示列表的View。

2.适配器 用来把数据映射到ListView上的中介。

3.数据    具体的将被映射的字符串,图片,或者基本组件。

根据列表的适配器类型,列表分为三种,ArrayAdapter,SimpleAdapter和SimpleCursorAdapter

其中以ArrayAdapter最为简单,只能展示一行字。SimpleAdapter有最好的扩充性,可以自定义出各种效果。SimpleCursorAdapter可以认为是SimpleAdapter对数据库的简单结合,可以方面的把数据库的内容以列表的形式展示出来。

 我们从最简单的ListView开始:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
/**
  * @author allin
  *
  */
public  class  MyListView extends  Activity {
 
     private  ListView listView;
     //private List<String> data = new ArrayList<String>();
     @Override
     public  void  onCreate(Bundle savedInstanceState){
         super .onCreate(savedInstanceState);
         
         listView = new  ListView( this );
         listView.setAdapter( new  ArrayAdapter<String>( this , android.R.layout.simple_expandable_list_item_1,getData()));
         setContentView(listView);
     }
     
     
     
     private  List<String> getData(){
         
         List<String> data = new  ArrayList<String>();
         data.add( "测试数据1" );
         data.add( "测试数据2" );
         data.add( "测试数据3" );
         data.add( "测试数据4" );
         
         return  data;
     }
}

上面代码使用了ArrayAdapter(Context context, int textViewResourceId, List<T> objects)来装配数据,要装配这些数据就需要一个连接ListView视图对象和数组数据的适配器来两者的适配工作,ArrayAdapter的构造需要三个参数,依次为this,布局文件(注意这里的布局文件描述的是列表的每一行的布局,android.R.layout.simple_list_item_1是系统定义好的布局文件只显示一行文字,数据源(一个List集合)。同时用setAdapter()完成适配的最后工作。运行后的现实结构如下图:

SimpleCursorAdapter

  sdk的解释是这样的:An easy adapter to map columns from a cursor to TextViews or ImageViews defined in an XML file. You can specify which columns you want, which views you want to display the columns, and the XML file that defines the appearance of these views。简单的说就是方便把从游标得到的数据进行列表显示,并可以把指定的列映射到对应的TextView中。

  下面的程序是从电话簿中把联系人显示到类表中。先在通讯录中添加一个联系人作为数据库的数据。然后获得一个指向数据库的Cursor并且定义一个布局文件(当然也可以使用系统自带的)。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
/**
  * @author allin
  *
  */
public  class  MyListView2 extends  Activity {
 
     private  ListView listView;
     //private List<String> data = new ArrayList<String>();
     @Override
     public  void  onCreate(Bundle savedInstanceState){
         super .onCreate(savedInstanceState);
         
         listView = new  ListView( this );
         
         Cursor cursor = getContentResolver().query(People.CONTENT_URI, null , null , null , null );
         startManagingCursor(cursor);
         
         ListAdapter listAdapter = new  SimpleCursorAdapter( this , android.R.layout.simple_expandable_list_item_1,
                 cursor,
                 new  String[]{People.NAME},
                 new  int []{android.R.id.text1});
         
         listView.setAdapter(listAdapter);
         setContentView(listView);
     }
     
     
}

 Cursor cursor = getContentResolver().query(People.CONTENT_URI, null, null, null, null);先获得一个指向系统通讯录数据库的Cursor对象获得数据来源。

 startManagingCursor(cursor);我们将获得的Cursor对象交由Activity管理,这样Cursor的生命周期和Activity便能够自动同步,省去自己手动管理Cursor。

 SimpleCursorAdapter 构造函数前面3个参数和ArrayAdapter是一样的,最后两个参数:一个包含数据库的列的String型数组,一个包含布局文件中对应组件id的int型数组。其作用是自动的将String型数组所表示的每一列数据映射到布局文件对应id的组件上。上面的代码,将NAME列的数据一次映射到布局文件的id为text1的组件上。

注意:需要在AndroidManifest.xml中如权限:<uses-permission android:name="android.permission.READ_CONTACTS"></uses-permission>

运行后效果如下图:

SimpleAdapter

simpleAdapter的扩展性最好,可以定义各种各样的布局出来,可以放上ImageView(图片),还可以放上Button(按钮),CheckBox(复选框)等等。下面的代码都直接继承了ListActivity,ListActivity和普通的Activity没有太大的差别,不同就是对显示ListView做了许多优化,方面显示而已。

下面的程序是实现一个带有图片的类表。

首先需要定义好一个用来显示每一个列内容的xml

vlist.xml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
<? xml  version="1.0" encoding="utf-8"?>
< LinearLayout  xmlns:android="http://schemas.android.com/apk/res/android"
     android:orientation="horizontal" android:layout_width="fill_parent"
     android:layout_height="fill_parent">
 
 
     < ImageView  android:id="@+id/img"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:layout_margin="5px"/>
 
     < LinearLayout  android:orientation="vertical"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content">
 
         < TextView  android:id="@+id/title"
             android:layout_width="wrap_content"
             android:layout_height="wrap_content"
             android:textColor="#FFFFFFFF"
             android:textSize="22px" />
         < TextView  android:id="@+id/info"
             android:layout_width="wrap_content"
             android:layout_height="wrap_content"
             android:textColor="#FFFFFFFF"
             android:textSize="13px" />
 
     </ LinearLayout >
 
 
</ LinearLayout >

下面是实现代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
/**
  * @author allin
  *
  */
public  class  MyListView3 extends  ListActivity {
 
 
     // private List<String> data = new ArrayList<String>();
     @Override
     public  void  onCreate(Bundle savedInstanceState) {
         super .onCreate(savedInstanceState);
 
         SimpleAdapter adapter = new  SimpleAdapter( this ,getData(),R.layout.vlist,
                 new  String[]{ "title" , "info" , "img" },
                 new  int []{R.id.title,R.id.info,R.id.img});
         setListAdapter(adapter);
     }
 
     private  List<Map<String, Object>> getData() {
         List<Map<String, Object>> list = new  ArrayList<Map<String, Object>>();
 
         Map<String, Object> map = new  HashMap<String, Object>();
         map.put( "title" , "G1" );
         map.put( "info" , "google 1" );
         map.put( "img" , R.drawable.i1);
         list.add(map);
 
         map = new  HashMap<String, Object>();
         map.put( "title" , "G2" );
         map.put( "info" , "google 2" );
         map.put( "img" , R.drawable.i2);
         list.add(map);
 
         map = new  HashMap<String, Object>();
         map.put( "title" , "G3" );
         map.put( "info" , "google 3" );
         map.put( "img" , R.drawable.i3);
         list.add(map);
         
         return  list;
     }
}

使用simpleAdapter的数据用一般都是HashMap构成的List,list的每一节对应ListView的每一行。HashMap的每个键值数据映射到布局文件中对应id的组件上。因为系统没有对应的布局文件可用,我们可以自己定义一个布局vlist.xml。下面做适配,new一个SimpleAdapter参数一次是:this,布局文件(vlist.xml),HashMap的 title 和 info,img。布局文件的组件id,title,info,img。布局文件的各组件分别映射到HashMap的各元素上,完成适配。

运行效果如下图:

有按钮的ListView

但是有时候,列表不光会用来做显示用,我们同样可以在在上面添加按钮。添加按钮首先要写一个有按钮的xml文件,然后自然会想到用上面的方法定义一个适配器,然后将数据映射到布局文件上。但是事实并非这样,因为按钮是无法映射的,即使你成功的用布局文件显示出了按钮也无法添加按钮的响应,这时就要研究一下ListView是如何现实的了,而且必须要重写一个类继承BaseAdapter。下面的示例将显示一个按钮和一个图片,两行字如果单击按钮将删除此按钮的所在行。并告诉你ListView究竟是如何工作的。效果如下:

vlist2.xml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
<? xml  version="1.0" encoding="utf-8"?>
< LinearLayout  xmlns:android="http://schemas.android.com/apk/res/android"
     android:orientation="horizontal"
     android:layout_width="fill_parent"
     android:layout_height="fill_parent">
 
 
     < ImageView  android:id="@+id/img"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:layout_margin="5px"/>
 
     < LinearLayout  android:orientation="vertical"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content">
 
         < TextView  android:id="@+id/title"
             android:layout_width="wrap_content"
             android:layout_height="wrap_content"
             android:textColor="#FFFFFFFF"
             android:textSize="22px" />
         < TextView  android:id="@+id/info"
             android:layout_width="wrap_content"
             android:layout_height="wrap_content"
             android:textColor="#FFFFFFFF"
             android:textSize="13px" />
 
     </ LinearLayout >
 
 
     < Button  android:id="@+id/view_btn"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:text="@string/s_view_btn"
         android:layout_gravity="bottom|right" />
</ LinearLayout >

程序代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
12
/**
  * @author allin
  *
  */
public  class  MyListView4 extends  ListActivity {
 
 
     private  List<Map<String, Object>> mData;
     
     @Override
     public  void  onCreate(Bundle savedInstanceState) {
         super .onCreate(savedInstanceState);
         mData = getData();
         MyAdapter adapter = new  MyAdapter( this );
         setListAdapter(adapter);
     }
 
     private  List<Map<String, Object>> getData() {
         List<Map<String, Object>> list = new  ArrayList<Map<String, Object>>();
 
         Map<String, Object> map = new  HashMap<String, Object>();
         map.put( "title" , "G1" );
         map.put( "info" , "google 1" );
         map.put( "img" , R.drawable.i1);
         list.add(map);
 
         map = new  HashMap<String, Object>();
         map.put( "title" , "G2" );
         map.put( "info" , "google 2" );
         map.put( "img" , R.drawable.i2);
         list.add(map);
 
         map = new  HashMap<String, Object>();
         map.put( "title" , "G3" );
         map.put( "info" , "google 3" );
         map.put( "img" , R.drawable.i3);
         list.add(map);
         
         return  list;
     }
     
     // ListView 中某项被选中后的逻辑
     @Override
     protected  void  onListItemClick(ListView l, View v, int  position, long  id) {
         
         Log.v( "MyListView4-click" , (String)mData.get(position).get( "title" ));
     }
     
     /**
      * listview中点击按键弹出对话框
      */
     public  void  showInfo(){
         new  AlertDialog.Builder( this )
         .setTitle( "我的listview" )
         .setMessage( "介绍..." )
         .setPositiveButton( "确定" , new  DialogInterface.OnClickListener() {
             @Override
             public  void  onClick(DialogInterface dialog, int  which) {
             }
         })
         .show();
         
     }
     
     
     
     public  final  class  ViewHolder{
         public  ImageView img;
         public  TextView title;
         public  TextView info;
         public  Button viewBtn;
     }
     
     
     public  class  MyAdapter extends  BaseAdapter{
 
         private  LayoutInflater mInflater;
         
         
         public  MyAdapter(Context context){
             this .mInflater = LayoutInflater.from(context);
         }
         @Override
         public  int  getCount() {
             // TODO Auto-generated method stub
             return  mData.size();
         }
 
         @Override
         public  Object getItem( int  arg0) {
             // TODO Auto-generated method stub
             return  null ;
         }
 
         @Override
         public  long  getItemId( int  arg0) {
             // TODO Auto-generated method stub
             return  0 ;
         }
 
         @Override
         public  View getView( int  position, View convertView, ViewGroup parent) {
             
             ViewHolder holder = null ;
             if  (convertView == null ) {
                 
                 holder= new  ViewHolder(); 
                 
                 convertView = mInflater.inflate(R.layout.vlist2, null );
                 holder.img = (ImageView)convertView.findViewById(R.id.img);
                 holder.title = (TextView)convertView.findViewById(R.id.title);
                 holder.info = (TextView)convertView.findViewById(R.id.info);
                 holder.viewBtn = (Button)convertView.findViewById(R.id.view_btn);
                 convertView.setTag(holder);
                 
             } else  {
                 
                 holder = (ViewHolder)convertView.getTag();
             }
             
             
             holder.img.setBackgroundResource((Integer)mData.get(position).get( "img" ));
             holder.title.setText((String)mData.get(position).get( "title" ));
             holder.info.setText((String)mData.get(position).get( "info" ));
             
             holder.viewBtn.setOnClickListener( new  View.OnClickListener() {
                 
                 @Override
                 public  void  onClick(View v) {
                     showInfo();                
                 }
             });
             
             
             return  convertView;
         }
         
     }
     
     
     
      }

  下面将对上述代码,做详细的解释,listView在开始绘制的时候,系统首先调用getCount()函数,根据他的返回值得到listView的长度(这也是为什么在开始的第一张图特别的标出列表长度),然后根据这个长度,调用getView()逐一绘制每一行。如果你的getCount()返回值是0的话,列表将不显示同样return 1,就只显示一行。

  系统显示列表时,首先实例化一个适配器(这里将实例化自定义的适配器)。当手动完成适配时,必须手动映射数据,这需要重写getView()方法。系统在绘制列表的每一行的时候将调用此方法。getView()有三个参数,position表示将显示的是第几行,covertView是从布局文件中inflate来的布局。我们用LayoutInflater的方法将定义好的vlist2.xml文件提取成View实例用来显示。然后将xml文件中的各个组件实例化(简单的findViewById()方法)。这样便可以将数据对应到各个组件上了。但是按钮为了响应点击事件,需要为它添加点击监听器,这样就能捕获点击事件。至此一个自定义的listView就完成了,现在让我们回过头从新审视这个过程。系统要绘制ListView了,他首先获得要绘制的这个列表的长度,然后开始绘制第一行,怎么绘制呢?调用getView()函数。在这个函数里面首先获得一个View(实际上是一个ViewGroup),然后再实例并设置各个组件,显示之。好了,绘制完这一行了。那 再绘制下一行,直到绘完为止。在实际的运行过程中会发现listView的每一行没有焦点了,这是因为Button抢夺了listView的焦点,只要布局文件中将Button设置为没有焦点就OK了。

运行效果如下图:

源码下载



ListView的属性

[java]  view plain  copy
  1. ListView 去除滑动颜色。  

代码实现清除滑动色setCacheColorHint(Android.R.color.transparent);

[html]  view plain  copy
  1. android:cacheColorHint="@android:color/transparent"  

去除点击颜色

[html]  view plain  copy
  1. android:listSelector="@android:color/transparent"  

 代码实现清除点击色setSelector(android.R.color.transparent);

设定item宽和高

item 首先适应自己内容的大小,通过下面给以下两个方法传值改变宽高
[java]  view plain  copy
  1. convertView.setMinimumWidth();  
  2. convertView.setMinimumHeight();  

传值只能大于item内容大小,小于不起作用

去除滚动条

[html]  view plain  copy
  1. android:scrollbars="none"  

去除ListView滑到顶部和底部时边缘的黑色阴影:

[java]  view plain  copy
  1. android:fadingEdge="none"  

listView 分割线

[html]  view plain  copy
  1. android:divider="@color/gray"  
  2.               android:dividerHeight="1dp"  

自定义完颜色后必须再设置高否则,将不显示分割线

listItem 中包含 ImageButton,Button,CheckBox等子控件会与 listView抢夺焦点

在根布局中添加 

[html]  view plain  copy
  1. android:descendantFocusability="blocksDescendants"  

在抢夺焦点的控件中添加

[html]  view plain  copy
  1. android:focusable="false"  

  第二是 transciptMode属性,需要用ListView或者其它显示大量Items的控件实时跟踪或者查看信息,并且希望最新的条目可以自动滚动到可视范围内。通过设置的控件transcriptMode属性可以将Android平台的控件(支持ScrollBar)自动滑动到最底部。
[html]  view plain  copy
  1. android:transcriptMode="alwaysScroll"      


从执行ListView的removeFooterView时报错学到的东西

在做ListView滚动到底部时自动加载下一页数据时出现了错误

先看下ListView的setAdapter方法里的部分代码:

1 public void setAdapter(ListAdapter adapter) {
2         ............
3         if (mHeaderViewInfos.size() > 0|| mFooterViewInfos.size() > 0) {
4             mAdapter = new HeaderViewListAdapter(mHeaderViewInfos, mFooterViewInfos, adapter);
5         else {
6             mAdapter = adapter;
7         }
8         ............
9     }

代码的大致意思是如果ListView没有headerView或者footerView的时候,与listView相关联的Adapter就是传进来的参数Adapter,如果有,就将原来的Adapter包装成HeaderViewListAdapter。
至此大致明白了错在哪里了,因为一开始第一页的时候用不到footerView,所以一开始创建的Adapter并不是HeaderViewListAdapter,然后在加载下一页的时候有添加和删除footerView的操作,但是当前的Adapter并不是HeaderViewListAdapter,导致错误发生,报了java.lang.ClassCastException错误。
明白了错误,也就有了相应的解决方案了。在setAdapter执行前如果之后需要headerView或者footerView的,可以先add到ListView里,如果不需要一开始的时候显示,可以在setAdapter后立刻remove掉就好了,这样子处理主要是为了让创建的是Adapter是HeaderViewListAdapter。


 

ListView 分页加载


当过多的数据需要在ListView上显示时,一下子加载全部数据,界面会出现卡顿现象,很影响用户体验,这时需要分几次加载完成。

实现这个功能需要一个 OnScrollListener 接口 ,和一个footView 的布局文件
1.footVIew布局文件   很简单能表示正在加载即可

[html]  view plain  copy
  1. <?xml version="1.0" encoding="utf-8"?>  
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
  3.     android:layout_width="match_parent"  
  4.     android:layout_height="match_parent"  
  5.     android:gravity="center_horizontal"  
  6.     android:orientation="vertical" >  
  7.   
  8.     <TextView  
  9.         android:layout_width="match_parent"  
  10.         android:layout_height="match_parent"  
  11.         android:text="加载更多" />  
  12.   
  13. </LinearLayout>  

此时我在调用listView.removeFootView(view);的时候出现了一个错无,查找原因后终于明白

listView在set  Adapter 类之前,一定要先listView.addFooterView(footerView);

因为ListView会根据 是否有footView创建不同的 Adapter类  看源码

[java]  view plain  copy
  1. public void setAdapter(ListAdapter adapter) {  
  2.         if (mHeaderViewInfos.size() > 0|| mFooterViewInfos.size() > 0) {  
  3.             mAdapter = new HeaderViewListAdapter(mHeaderViewInfos, mFooterViewInfos, adapter);  
  4.         } else {  
  5.             mAdapter = adapter;  
  6.         }  
  7. }  

在set方法之前没有addFootView 那么我调用removeFootView就会报类异常的错误,在此特意指出,以后避免类似错误的产生
2.创建一个滑动监听类

[java]  view plain  copy
  1. private class MyScrollListener implements OnScrollListener {  
  2.   
  3.   
  4.         private boolean addFlag;  
  5.   
  6.         @Override  
  7.         public void onScrollStateChanged(AbsListView view, int scrollState) {  
  8.               
  9.   
  10.         }  
  11.   
  12.         @Override  
  13.         public void onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount, int totalItemCount) {  
  14.               
  15.             if (totalItemCount == visibleItemCount + firstVisibleItem && firstVisibleItem != 0 && !addFlag) {  
  16.                 // TODO 加载新的数据项  
  17.                   
  18.                 //如果有数据  就addFlag = true; 以便下次还能进入if语句进行加载  
  19.                         listView.setSelection(totalItemCount-1); //让listView显示新加载项  
  20.   
  21.             }  
  22.         }  
  23.     }  
根据实践,数据从数据库拉取,就不必添加Footview 因为速度很快,几乎看不到就已经加载完成。
listView显示网路图片,并保存本地
别人上图上例子,代码量很多但是使用方法简单除了MainActivity之外其余的java文件全部复制到你的工程,MainActivity里有使用方法例子下载地址 http://download.csdn.net/detail/zhixun2012/4969703

ListView优化:

了解ListView加载数据的原理,有了这方面的了解后再说优化才行,下面先跟大家一起来看下ListView加载数据的基本原理小马就直接写了:

ListView的工作原理如下:

                 ListView 针对每个item,要求 adapter “返回一个视图” (getView),也就是说ListView在开始绘制的时候,系统首先调用getCount()函数,根据他的返回值得到ListView的长度,然后根据这个长度,调用getView()一行一行的绘制ListView的每一项。如果你的getCount()返回值是0的话,列表一行都不会显示,如果返回1,就只显示一行。返回几则显示几行。如果我们有几千几万甚至更多的item要显示怎么办?为每个Item创建一个新的View?不可能!!!实际上Android早已经缓存了这些视图,大家可以看下下面这个截图来理解下,这个图是解释ListView工作原理的最经典的图了大家可以收藏下,不懂的时候拿来看看,加深理解,其实Android中有个叫做Recycler的构件,顺带列举下与Recycler相关的已经由Google做过N多优化过的东东比如:AbsListView.RecyclerListener、ViewDebug.RecyclerTraceType等等,要了解的朋友自己查下,不难理解,下图是ListView加载数据的工作原理(原理图看不清楚的点击后看大图):

Android研究院之ListView原理学习与优化总结(二十一) - 雨松MOMO程序研究院 - 1

下面简单说下上图的原理:

  1. 如果你有几千几万甚至更多的选项(item)时,其中只有可见的项目存在内存(内存内存哦,说的优化就是说在内存中的优化!!!)中,其他的在Recycler中
  2. ListView先请求一个type1视图(getView)然后请求其他可见的项目。convertView在getView中是空(null)的
  3. 当item1滚出屏幕,并且一个新的项目从屏幕低端上来时,ListView再请求一个type1视图。convertView此时不是空值了,它的值是item1。你只需设定新的数据然后返回convertView,不必重新创建一个视图

             下面来看下小马从网上找来的示例代码,网址搞丢了,只有一个word文档,只能 copy过来,不然直接贴网址,结合上面的原理图一起加深理解,如下: