Android学习系列(15)--App列表之游标ListView(索引ListView)
游标ListView,提供索引标签,使用户能够快速定位列表项。
也可以叫索引ListView,有的人称也为Tweaked ListView,可能更形象些吧。
一看图啥都懂了:
1.游标(Fast scroll thumb)
就是右边的那个拖动的方块,这个非常的简单:
1
2
3
4
5
|
< ListView android:id="@+id/tweaked_list" android:layout_width="fill_parent" android:layout_height="wrap_content" android:fastScrollEnabled="true"/> |
也可以用在java后台书写:
1
|
tweakedListView.setFastScrollEnabled( true ); |
在数据量有一定大的时候,滑动列表,就会出现右边的所谓的"游标"了。
简单,这也是我为什么私下里喜欢自己写控件,但是工作中却喜欢用通用控件。
我们看下源代码,其实就是启用FastScroller对象:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
//启用FastScroller对象 public void setFastScrollEnabled( boolean enabled) { mFastScrollEnabled = enabled; if (enabled) { if (mFastScroller == null ) { mFastScroller = new FastScroller(getContext(), this ); } } else { if (mFastScroller != null ) { mFastScroller.stop(); mFastScroller = null ; } } } |
2.字母索引
在Android学习系列(10)--App列表之拖拽ListView(上)中我们使用了一种WindowManager在ListView中添加一些自定义影像,这种方法我觉得一定是可行的。
但是,android系统给我们提供了一个更简单的方法:使用AlphabetIndexer。
AlphabetIndexer,实现了SectionIndexer接口,是adapter的一个辅助类,辅助实现在快滑时,显示索引字母。
使用字母索引的话,必须保证数据列表是按字母顺序排序,以便AlphabetIndexerh采用二分查找法快速定位。
1
2
3
4
5
6
|
/** * Cursor表示数据游标 * sortedColumnIndex数据集合中的第几列 * alphabet字母列表,用的最多的是"ABCDEFGHIJKLMNOPQRSTUVWXYZ" **/ public AlphabetIndexer(Cursor cursor, int sortedColumnIndex, CharSequence alphabet) {} |
用到3个方法:
1
2
3
4
|
//这三个方法,实现了索引数据和列表数据的对应和定位 public int getPositionForSection( int section) {} public int getSectionForPosition( int position) {} public Object[] getSections() {} |
3.游标Cursor的实现
Cursor接口的实现,有两种选择:
(1).直接使用数据库查询返回的cursor
(2).自定义实现Cursor接口的新类
第一种方式很简单,查询一下数据库返回Cursor即可。
这里我们以第二种方式实践,伪装一个Cursor,主要是实现3个方法:
(1).getCount()
(2). moveToPosition()
(3). getString()
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
|
/** * 伪装一个Cursor供AlphabetIndexer作数据索引源 */ private class IndexCursor implements Cursor{ private ListAdapter adapter; private int position; private Map<String, String> map; public IndexCursor(ListAdapter adapter){ this .adapter = adapter; } @Override public int getCount() { return this .adapter.getCount();} /** * 取得索引字母,这个方法非常重要,根据实际情况具体处理 */ @SuppressWarnings ( "unchecked" ) @Override public String getString( int columnIndex) { map = (HashMap<String, String>)adapter.getItem(position); return map.get(key).substring( 0 , 1 ); } @Override public boolean moveToPosition( int position) { if (position<- 1 ||position>getCount()){ return false ; } this .position = position; //如果不满意位置有点向上偏的话,下面这几行代码是修复定位索引值为顶部项值的问题 //if(position+2>getCount()){ // this.position = position; //}else{ // this.position = position + 2; //} return true ; } @Override public void close() {} @Override public void copyStringToBuffer( int arg0, CharArrayBuffer arg1) {} @Override public void deactivate() {} @Override public byte [] getBlob( int arg0) { return null ;} @Override public int getColumnCount() { return 0 ;} @Override public int getColumnIndex(String columnName) { return 0 ;} @Override public int getColumnIndexOrThrow(String columnName) throws IllegalArgumentException { return 0 ;} @Override public String getColumnName( int columnIndex) { return null ;} @Override public String[] getColumnNames() { return null ;} @Override public double getDouble( int columnIndex) { return 0 ;} @Override public Bundle getExtras() { return null ;} @Override public float getFloat( int columnIndex) { return 0 ;} @Override public int getInt( int columnIndex) { return 0 ;} @Override public long getLong( int columnIndex) { return 0 ;} @Override public int getPosition() { return position;} @Override public short getShort( int columnIndex) { return 0 ;} @Override public boolean getWantsAllOnMoveCalls() { return false ;} @Override public boolean isAfterLast() { return false ;} @Override public boolean isBeforeFirst() { return false ;} @Override public boolean isClosed() { return false ;} @Override public boolean isFirst() { return false ;} @Override public boolean isLast() { return false ;} @Override public boolean isNull( int columnIndex) { return false ;} @Override public boolean move( int offset) { return false ;} @Override public boolean moveToFirst() { return false ;} @Override public boolean moveToLast() { return false ;} @Override public boolean moveToNext() { return false ;} @Override public boolean moveToPrevious() { return false ;} @Override public void registerContentObserver(ContentObserver observer) {} @Override public void registerDataSetObserver(DataSetObserver observer) {} @Override public boolean requery() { return false ;} @Override public Bundle respond(Bundle extras) { return null ;} @Override public void setNotificationUri(ContentResolver cr, Uri uri) {} @Override public void unregisterContentObserver(ContentObserver observer) {} @Override public void unregisterDataSetObserver(DataSetObserver observer) {} } |
这个类的实例就可作为AlphaIndexer的构造函数第一个参数数据游标。
4.自定义Adapter的实现
使用前面介绍的东西,我们来实现最终的IndexAdapter:
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
|
class IndexAdapter extends SimpleAdapter implements SectionIndexer{ private AlphabetIndexer alphabetIndexer; public IndexAdapter(Context context,List<? extends Map<String, ?>> data, int resource,String[] from, int [] to) { super (context, data, resource, from, to); //设置数据游标 //设置索引字母列表 alphabetIndexer = new AlphabetIndexer( new IndexCursor( this ), 0 , "ABCDEFGHIJKLMNOPQRSTUVWXYZ" ); } @Override public Object[] getSections() { return alphabetIndexer.getSections(); } @Override public int getPositionForSection( int section) { return alphabetIndexer.getPositionForSection(section); } @Override public int getSectionForPosition( int position) { return alphabetIndexer.getSectionForPosition(position); } } |
5.跑起来
提供样本数据如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
public List<Map<String, String>> getData(){ List<Map<String, String>> itemList = new ArrayList<Map<String, String>>(); String alphas = "ABCDEFGHIJKLMNOPQRSTUVWXYZ" ; Map<String, String> map = null ; for ( char c:alphas.toCharArray()){ for ( int i= 0 ; i< 10 ; i++){ map = new HashMap<String, String>(); map.put( "itemText" , "" +c+i); itemList.add(map); } } return itemList; } |
子项的布局文件:
1
2
3
4
5
6
7
8
9
10
11
12
|
<? xml version="1.0" encoding="utf-8"?> android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="50dip" android:gravity="center_vertical" > < TextView android:id="@+id/tweaked_item_text" android:layout_width="fill_parent" android:layout_height="wrap_content" /> </ LinearLayout > |
使用并运行:
1
2
3
4
5
6
7
8
9
10
11
|
protected void onCreate(Bundle savedInstanceState) { super .onCreate(savedInstanceState); setContentView(R.layout.tweake_list); tweakedListView = (ListView)findViewById(R.id.tweaked_list); //获取数据 List<Map<String, String>> itemList = getData(); ListAdapter adapter = new IndexAdapter( this , itemList, R.layout.tweake_list_item, new String[]{ "itemText" }, new int []{R.id.tweaked_item_text}); tweakedListView.setAdapter(adapter); } |
效果如下:
6.小结
这种索引效果,在大数据量列表显示中非常的实用,是android开发必备常识。
本文只是一个简单的sample,实际工作中肯定会需要进一步扩展定义:
(1).对于复杂类型的处理,可根据Map<String,?>扩展自定义实体类,再通过adapter转换使用即可。
(2).对于索引字母列表,可动态设置,举个例子,你的列表只有ABCD四个字母,如果索引字母列表还是设置“ABCDEFGHIJKLMNOPQRSTUVWXYZ”就不合适了,会有个索引偏位的问题。
(3).对于复杂界面的显示,可重写adapter的getView方法自定义视图。