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

时间:2022-02-25 03:16:42

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

Android学习系列(15)--App列表之游标ListView(索引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"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    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);
}

  效果如下:

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

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