Android学习系列(15)--App列表之游标ListView(索引ListView)

游标ListView，提供索引标签，使用户能够快速定位列表项。
      也可以叫索引ListView，有的人称也为Tweaked ListView，可能更形象些吧。
      一看图啥都懂了：

<ignore_js_op>

1.游标(Fast scroll thumb)
      就是右边的那个拖动的方块，这个非常的简单：

1. <ListView
2.     android:id="@+id/tweaked_list"
3.     android:layout_width="fill_parent" 
4.     android:layout_height="wrap_content" 
5.     android:fastScrollEnabled="true"/>

复制代码

也可以用在java后台书写：

1. tweakedListView.setFastScrollEnabled(true);

复制代码

在数据量有一定大的时候，滑动列表，就会出现右边的所谓的"游标"了。
      简单，这也是我为什么私下里喜欢自己写控件，但是工作中却喜欢用通用控件。
      我们看下源代码，其实就是启用FastScroller对象： 

1. //启用FastScroller对象
2. public void setFastScrollEnabled(boolean enabled) {
3.     mFastScrollEnabled = enabled;
4.     if (enabled) {
5.         if (mFastScroller == null) {
6.             mFastScroller = new FastScroller(getContext(), this);
7.         }
8.     } else {
9.         if (mFastScroller != null) {
10.             mFastScroller.stop();
11.             mFastScroller = null;
12.         }
13.     }
14. }

复制代码

2.字母索引
     在Android学习系列(10)--App列表之拖拽ListView(上)中我们使用了一种WindowManager在ListView中添加一些自定义影像，这种方法我觉得一定是可行的。
   但是，android系统给我们提供了一个更简单的方法：使用AlphabetIndexer。
   AlphabetIndexer,实现了SectionIndexer接口,是adapter的一个辅助类,辅助实现在快滑时，显示索引字母。
   使用字母索引的话，必须保证数据列表是按字母顺序排序，以便AlphabetIndexerh采用二分查找法快速定位。

1. /**
2. * Cursor表示数据游标
3. * sortedColumnIndex数据集合中的第几列
4. * alphabet字母列表，用的最多的是"ABCDEFGHIJKLMNOPQRSTUVWXYZ"
5. **/
6. public AlphabetIndexer(Cursor cursor, int sortedColumnIndex, CharSequence alphabet) {}

复制代码

用到3个方法：

1. //这三个方法，实现了索引数据和列表数据的对应和定位
2. public int getPositionForSection(int section) {}
3. public int getSectionForPosition(int position) {}
4. public Object[] getSections() {}

复制代码

3.游标Cursor的实现
     Cursor接口的实现，有两种选择：
     (1).直接使用数据库查询返回的cursor
     (2).自定义实现Cursor接口的新类
     第一种方式很简单，查询一下数据库返回Cursor即可。
     这里我们以第二种方式实践，伪装一个Cursor,主要是实现3个方法:
     (1).getCount()
     (2). moveToPosition()
     (3). getString()

1. /**
2.     * 伪装一个Cursor供AlphabetIndexer作数据索引源
3.     */
4.    private class IndexCursor implements Cursor{
5.        
6.        private ListAdapter adapter;
7.        private int position;
8.        private Map<String, String> map;
9.        
10.        public IndexCursor(ListAdapter adapter){
11.            this.adapter = adapter;
12.        }
14.        @Override
15.        public int getCount() {return this.adapter.getCount();}
16.        
17.        /**
18.         * 取得索引字母，这个方法非常重要，根据实际情况具体处理
19.         */
20.        @SuppressWarnings("unchecked")
21.        @Override
22.        public String getString(int columnIndex) {
23.            map = (HashMap<String, String>)adapter.getItem(position);
24.            return map.get(key).substring(0,1);
25.        }
26.        
27.        @Override
28.        public boolean moveToPosition(int position) {
29.            if(position<-1||position>getCount()){
30.                return false;
31.            }
32.            
33.            this.position = position;
34.            //如果不满意位置有点向上偏的话，下面这几行代码是修复定位索引值为顶部项值的问题
35.            //if(position+2>getCount()){                
36.            //    this.position = position;
37.            //}else{
38.            //   this.position = position + 2;
39.            //}
40.            return true;
41.        }
42.        
43.        @Override
44.        public void close() {}
45.        @Override
46.        public void copyStringToBuffer(int arg0, CharArrayBuffer arg1) {}
47.        @Override
48.        public void deactivate() {}
49.        @Override
50.        public byte[] getBlob(int arg0) {return null;}
51.        @Override
52.        public int getColumnCount() {return 0;}
53.        @Override
54.        public int getColumnIndex(String columnName) {return 0;}
55.        @Override
56.        public int getColumnIndexOrThrow(String columnName) throws IllegalArgumentException {return 0;}
57.        @Override
58.        public String getColumnName(int columnIndex) {return null;}
59.        @Override
60.        public String[] getColumnNames() {return null;}
61.        @Override
62.        public double getDouble(int columnIndex) {return 0;}
63.        @Override
64.        public Bundle getExtras() {return null;}
65.        @Override
66.        public float getFloat(int columnIndex) {return 0;}
67.        @Override
68.        public int getInt(int columnIndex) {return 0;}
69.        @Override
70.        public long getLong(int columnIndex) {return 0;}
71.        @Override
72.        public int getPosition() {return position;}
73.        @Override
74.        public short getShort(int columnIndex) {return 0;}
75.        @Override
76.        public boolean getWantsAllOnMoveCalls() {return false;}
77.        @Override
78.        public boolean isAfterLast() {return false;}
79.        @Override
80.        public boolean isBeforeFirst() {return false;}
81.        @Override
82.        public boolean isClosed() {return false;}
83.        @Override
84.        public boolean isFirst() {return false;}
85.        @Override
86.        public boolean isLast() {return false;}
87.        @Override
88.        public boolean isNull(int columnIndex) {return false;}
89.        @Override
90.        public boolean move(int offset) {return false;}
91.        @Override
92.        public boolean moveToFirst() {return false;}
93.        @Override
94.        public boolean moveToLast() {return false;}
95.        @Override
96.        public boolean moveToNext() {return false;}
97.        @Override
98.        public boolean moveToPrevious() {return false;}
99.        @Override
100.        public void registerContentObserver(ContentObserver observer) {}
101.        @Override
102.        public void registerDataSetObserver(DataSetObserver observer) {}
103.        @Override
104.        public boolean requery() {return false;}
105.        @Override
106.        public Bundle respond(Bundle extras) {return null;}
107.        @Override
108.        public void setNotificationUri(ContentResolver cr, Uri uri) {}
109.        @Override
110.        public void unregisterContentObserver(ContentObserver observer) {}
111.        @Override
112.        public void unregisterDataSetObserver(DataSetObserver observer) {}
113.        
114.    }

复制代码

　这个类的实例就可作为AlphaIndexer的构造函数第一个参数数据游标。

4.自定义Adapter的实现
      使用前面介绍的东西，我们来实现最终的IndexAdapter:

1. class IndexAdapter extends SimpleAdapter implements SectionIndexer{
2.     
3.     private AlphabetIndexer alphabetIndexer;
4.     
5.     public IndexAdapter(Context context,List<? extends Map<String, ?>> data, int resource,String[] from, int[] to) {
6.         super(context, data, resource, from, to);
7.         //设置数据游标
8.         //设置索引字母列表
9.         alphabetIndexer = new AlphabetIndexer(new IndexCursor(this), 0, "ABCDEFGHIJKLMNOPQRSTUVWXYZ");
10.     }
12.     @Override
13.     public Object[] getSections() {
14.         return alphabetIndexer.getSections();
15.     }
17.     @Override
18.     public int getPositionForSection(int section) {
19.         return alphabetIndexer.getPositionForSection(section);
20.     }
22.     @Override
23.     public int getSectionForPosition(int position) {
24.         return alphabetIndexer.getSectionForPosition(position);
25.     }
26. }

复制代码

5.跑起来
     提供样本数据如下：

1. public List<Map<String, String>> getData(){
2.     List<Map<String, String>> itemList = new ArrayList<Map<String, String>>();
3.     String alphas = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
4.     
5.     Map<String, String> map = null;
6.     for(char c:alphas.toCharArray()){
7.         for(int i=0; i<10; i++){                
8.             map = new HashMap<String, String>();
9.             map.put("itemText", ""+c+i);
10.             itemList.add(map);
11.         }
12.     }
14.     return itemList;
15. }

复制代码

　子项的布局文件：

1. <?xml version="1.0" encoding="utf-8"?>
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
3.     android:orientation="vertical"
4.     android:layout_width="fill_parent"
5.     android:layout_height="50dip"
6.     android:gravity="center_vertical"
7.     >
8.     <TextView 
9.         android:id="@+id/tweaked_item_text"
10.         android:layout_width="fill_parent" 
11.         android:layout_height="wrap_content" />
12. </LinearLayout>

复制代码

　　使用并运行：

1. protected void onCreate(Bundle savedInstanceState) {
2.     super.onCreate(savedInstanceState);
3.     setContentView(R.layout.tweake_list);
4.     
5.     tweakedListView = (ListView)findViewById(R.id.tweaked_list);
6.     
7.     //获取数据
8.     List<Map<String, String>> itemList = getData();
9.     ListAdapter adapter = new IndexAdapter(this, itemList, R.layout.tweake_list_item, new String[]{"itemText"}, new int[]{R.id.tweaked_item_text});
10.     tweakedListView.setAdapter(adapter);
11. }

复制代码

效果如下：

<ignore_js_op>

6.小结
      这种索引效果，在大数据量列表显示中非常的实用，是Android开发必备常识。
      本文只是一个简单的sample，实际工作中肯定会需要进一步扩展定义：
      (1).对于复杂类型的处理，可根据Map<String,?>扩展自定义实体类，再通过adapter转换使用即可。
      (2).对于索引字母列表，可动态设置，举个例子，你的列表只有ABCD四个字母，如果索引字母列表还是设置“ABCDEFGHIJKLMNOPQRSTUVWXYZ”就不合适了，会有个索引偏位的问题。
      (3).对于复杂界面的显示，可重写adapter的getView方法自定义视图。