App列表之游标ListView(索引ListView)

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

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

view sourceprint?

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后台书写：

view sourceprint?

1tweakedListView.setFastScrollEnabled(true);

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

view sourceprint?

01//启用FastScroller对象

02public void setFastScrollEnabled(booleanenabled) {

03    mFastScrollEnabled = enabled;

04    if(enabled) {

05        if(mFastScroller == null) {

06            mFastScroller =new FastScroller(getContext(),this);

07        }

08    } else {

09        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采用二分查找法快速定位。

view sourceprint?

1/**

2* Cursor表示数据游标

3* sortedColumnIndex数据集合中的第几列

4* alphabet字母列表，用的最多的是"ABCDEFGHIJKLMNOPQRSTUVWXYZ"

5**/

6public AlphabetIndexer(Cursor cursor, int sortedColumnIndex, CharSequence alphabet) {}

　　用到3个方法：

view sourceprint?

1//这三个方法，实现了索引数据和列表数据的对应和定位

2public int getPositionForSection(intsection) {}

3public int getSectionForPosition(intposition) {}

4public Object[] getSections() {}

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

view sourceprint?

001/**

002    * 伪装一个Cursor供AlphabetIndexer作数据索引源

003    */

004   privateclass IndexCursor implements Cursor{

005         

006       privateListAdapter adapter;

007       privateint position;

008       privateMap<String, String> map;

009         

010       publicIndexCursor(ListAdapter adapter){

011           this.adapter = adapter;

012       }

013 

014       @Override

015       publicint getCount() {returnthis.adapter.getCount();}

016         

017       /**

018        * 取得索引字母，这个方法非常重要，根据实际情况具体处理

019        */

020       @SuppressWarnings("unchecked")

021       @Override

022       publicString getString(intcolumnIndex) {

023           map = (HashMap<String, String>)adapter.getItem(position);

024           returnmap.get(key).substring(0,1);

025       }

026         

027       @Override

028       publicboolean moveToPosition(intposition) {

029           if(position<-1||position>getCount()){

030               returnfalse;

031           }

032             

033           this.position = position;

034           //如果不满意位置有点向上偏的话，下面这几行代码是修复定位索引值为顶部项值的问题

035           //if(position+2>getCount()){                

036           //    this.position = position;

037           //}else{

038           //   this.position = position + 2;

039           //}

040           returntrue;

041       }

042         

043       @Override

044       publicvoid close() {}

045       @Override

046       publicvoid copyStringToBuffer(intarg0, CharArrayBuffer arg1) {}

047       @Override

048       publicvoid deactivate() {}

049       @Override

050       publicbyte[] getBlob(intarg0) {return null;}

051       @Override

052       publicint getColumnCount() {return0;}

053       @Override

054       publicint getColumnIndex(String columnName) {return0;}

055       @Override

056       publicint getColumnIndexOrThrow(String columnName)throws IllegalArgumentException {return0;}

057       @Override

058       publicString getColumnName(intcolumnIndex) {returnnull;}

059       @Override

060       publicString[] getColumnNames() {returnnull;}

061       @Override

062       publicdouble getDouble(intcolumnIndex) {return0;}

063       @Override

064       publicBundle getExtras() {returnnull;}

065       @Override

066       publicfloat getFloat(intcolumnIndex) {return0;}

067       @Override

068       publicint getInt(intcolumnIndex) {return0;}

069       @Override

070       publiclong getLong(intcolumnIndex) {return0;}

071       @Override

072       publicint getPosition() {returnposition;}

073       @Override

074       publicshort getShort(intcolumnIndex) {return0;}

075       @Override

076       publicboolean getWantsAllOnMoveCalls() {returnfalse;}

077       @Override

078       publicboolean isAfterLast() {returnfalse;}

079       @Override

080       publicboolean isBeforeFirst() {returnfalse;}

081       @Override

082       publicboolean isClosed() {returnfalse;}

083       @Override

084       publicboolean isFirst() {returnfalse;}

085       @Override

086       publicboolean isLast() {returnfalse;}

087       @Override

088       publicboolean isNull(intcolumnIndex) {returnfalse;}

089       @Override

090       publicboolean move(intoffset) {returnfalse;}

091       @Override

092       publicboolean moveToFirst() {returnfalse;}

093       @Override

094       publicboolean moveToLast() {returnfalse;}

095       @Override

096       publicboolean moveToNext() {returnfalse;}

097       @Override

098       publicboolean moveToPrevious() {returnfalse;}

099       @Override

100       publicvoid registerContentObserver(ContentObserver observer) {}

101       @Override

102       publicvoid registerDataSetObserver(DataSetObserver observer) {}

103       @Override

104       publicboolean requery() {returnfalse;}

105       @Override

106       publicBundle respond(Bundle extras) {returnnull;}

107       @Override

108       publicvoid setNotificationUri(ContentResolver cr, Uri uri) {}

109       @Override

110       publicvoid unregisterContentObserver(ContentObserver observer) {}

111       @Override

112       publicvoid unregisterDataSetObserver(DataSetObserver observer) {}

113         

114   }

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

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

view sourceprint?

01class IndexAdapter extends SimpleAdapter implements SectionIndexer{

02      

03    privateAlphabetIndexer alphabetIndexer;

04      

05    publicIndexAdapter(Context context,List<? extendsMap<String, ?>> data, intresource,String[] from, int[] to) {

06        super(context, data, resource, from, to);

07        //设置数据游标

08        //设置索引字母列表

09        alphabetIndexer =new AlphabetIndexer(newIndexCursor(this),0, "ABCDEFGHIJKLMNOPQRSTUVWXYZ");

10    }

11 

12    @Override

13    publicObject[] getSections() {

14        returnalphabetIndexer.getSections();

15    }

16 

17    @Override

18    publicint getPositionForSection(intsection) {

19        returnalphabetIndexer.getPositionForSection(section);

20    }

21 

22    @Override

23    publicint getSectionForPosition(intposition) {

24        returnalphabetIndexer.getSectionForPosition(position);

25    }

26}

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

view sourceprint?

01public List<Map<String, String>> getData(){

02    List<Map<String, String>> itemList =new ArrayList<Map<String, String>>();

03    String alphas ="ABCDEFGHIJKLMNOPQRSTUVWXYZ";

04      

05    Map<String, String> map =null;

06    for(charc:alphas.toCharArray()){

07        for(inti=0; i<10; i++){                

08            map =new HashMap<String, String>();

09            map.put("itemText",""+c+i);

10            itemList.add(map);

11        }

12    }

13 

14    returnitemList;

15}

　　子项的布局文件：

view sourceprint?

01<?xmlversion="1.0"encoding="utf-8"?>

02<LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"

03    android:orientation="vertical"

04    android:layout_width="fill_parent"

05    android:layout_height="50dip"

06    android:gravity="center_vertical"

07    >

08    <TextView 

09        android:id="@+id/tweaked_item_text"

10        android:layout_width="fill_parent" 

11        android:layout_height="wrap_content"/>

12</LinearLayout>

　　使用并运行：

view sourceprint?

01protected void onCreate(Bundle savedInstanceState) {

02    super.onCreate(savedInstanceState);

03    setContentView(R.layout.tweake_list);

04      

05    tweakedListView = (ListView)findViewById(R.id.tweaked_list);

06      

07    //获取数据

08    List<Map<String, String>> itemList = getData();

09    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}

　　效果如下：

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