列标头固定的联系人列表

 项目中有一新的需求，要求能像一些Android机带“联系人列表”一样，数据可以自动分组，且在列表滑动过程中，列表头固定在顶部，效果图如下：

  下面就带大家实现上面的效果， 首先，我们要介绍的一个重要的开源库：StickyListHeaders，它的Github地址是：https://github.com/emilsjolander/StickyListHeaders， 使用该库，可以更加方便的实现ListView数据分组，且Header固定在顶部。

  首先，把github上的项目下载下来，加压后，可看到其中有一个library库，我们需要将该库（Module）导入到新建的项目中，并在自己的Module引入该Library。

  项目建成后，开始使用该库进行开发：

1. 布局中引入StickyListHeadersListView：

[html]  view plain  copy

 print ?

1. <?xml version="1.0" encoding="utf-8"?>  
2. <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"  
3.     xmlns:tools="http://schemas.android.com/tools"  
4.     android:layout_width="match_parent"  
5.     android:layout_height="match_parent"  
6.     tools:context=".MainActivity">  
7.   
8.     <se.emilsjolander.stickylistheaders.StickyListHeadersListView  
9.         android:id="@+id/list"  
10.         android:layout_width="match_parent"  
11.         android:layout_height="match_parent"  
12.         android:cacheColorHint="#00000000"  
13.         android:clipToPadding="false"  
14.         android:drawSelectorOnTop="true"  
15.         android:fastScrollEnabled="true"  
16.         android:listSelector="#00000000"  
17.         android:overScrollMode="never"  
18.         android:scrollbarStyle="outsideOverlay" />  
19.   
20. </RelativeLayout>  

2. 创建要显示的数据实体

[java]  view plain  copy

 print ?

1. public class LangyaSimple {  
2.   
3.     private String id;  
4.     private String proj_id;  
5.     private String title;  
6.     private String desc;  
7.     private String project_title;  
8.   
9.     public LangyaSimple(String id, String proj_id, String title, String desc, String project_title) {  
10.         this.id = id;  
11.         this.proj_id = proj_id;  
12.         this.title = title;  
13.         this.desc = desc;  
14.         this. = project_title;  
15.     }  
16.   
17.     public String getId() {  
18.         return id;  
19.     }  
20.   
21.     public void setId(String id) {  
22.         this.id = id;  
23.     }  
24.   
25.     public String getProj_id() {  
26.         return proj_id;  
27.     }  
28.   
29.     public void setProj_id(String proj_id) {  
30.         this.proj_id = proj_id;  
31.     }  
32.   
33.     public String getTitle() {  
34.         return title;  
35.     }  
36.   
37.     public void setTitle(String title) {  
38.         this.title = title;  
39.     }  
40.   
41.     public String getDesc() {  
42.         return desc;  
43.     }  
44.   
45.     public void setDesc(String desc) {  
46.         this.desc = desc;  
47.     }  
48.   
49.     public String getProject_title() {  
50.         return project_title;  
51.     }  
52.   
53.     public void setProject_title(String project_title) {  
54.         this.project_title = project_title;  
55.     }  
56.   
57.     @Override  
58.     public String toString() {  
59.         return "LangyaSimple{" +  
60.                 "id='" + id + '\'' +  
61.                 ", proj_id='" + proj_id + '\'' +  
62.                 ", title='" + title + '\'' +  
63.                 ", desc='" + desc + '\'' +  
64.                 ", project_title='" + project_title + '\'' +  
65.                 '}';  
66.     }  
67. }  

注: id是data数据的id，proj_id是该数据所属的组的意思，proj_title是该组的名字；

3. 定义StickyListHeadersListView要显示的适配器：

[java]  view plain  copy

 print ?

1. import android.app.Activity;  
2. import android.view.LayoutInflater;  
3. import android.view.View;  
4. import android.view.ViewGroup;  
5. import android.widget.BaseAdapter;  
6. import android.widget.ImageView;  
7. import android.widget.TextView;  
8.   
9. import java.util.List;  
10.   
11. import se.emilsjolander.stickylistheaders.StickyListHeadersAdapter;  
12.   
13. public class LangyaAdapter extends BaseAdapter implements StickyListHeadersAdapter {  
14.   
15.     private LayoutInflater inflater;  
16.   
17.     private List<LangyaSimple> mPlanDetails;  
18.   
19.     public LangyaAdapter(Activity context, List<LangyaSimple> mPlanDetails) {  
20.         inflater = LayoutInflater.from(context);  
21.         this.mPlanDetails = mPlanDetails;  
22.   
23.     }  
24.   
25.     @Override  
26.     public int getCount() {  
27.         return mPlanDetails.size();  
28.     }  
29.   
30.     @Override  
31.     public Object getItem(int position) {  
32.         return mPlanDetails.get(position);  
33.     }  
34.   
35.     @Override  
36.     public long getItemId(int position) {  
37.         return position;  
38.     }  
39.   
40.     @Override  
41.     public View getView(int position, View convertView, ViewGroup parent) {  
42.         ViewHolder holder;  
43.   
44.         if (convertView == null) {  
45.             holder = new ViewHolder();  
46.             convertView = inflater.inflate(R.layout.list_item_proj_plan, parent, false);  
47.   
48.             holder.img_plan = (ImageView) convertView.findViewById(R.id.img_plan);  
49.   
50.             holder.text_plan_name = (TextView) convertView.findViewById(R.id.text_plan_name);  
51.             holder.text_plan_info = (TextView) convertView.findViewById(R.id.text_plan_info);  
52.   
53.             convertView.setTag(holder);  
54.         } else {  
55.             holder = (ViewHolder) convertView.getTag();  
56.         }  
57.   
58.         LangyaSimple planDetail = this.mPlanDetails.get(position);  
59.   
60.         if (planDetail != null) {  
61.   
62. //            ImageLoaderUtil.getInstance().displayListItemImage(imgUrl, holder.img_plan);  
63.             holder.text_plan_name.setText(planDetail.getTitle());  
64.             holder.text_plan_info.setText(planDetail.getDesc());  
65.         }  
66.   
67.         return convertView;  
68.     }  
69.   
70.     @Override  
71.     public View getHeaderView(int position, View convertView, ViewGroup parent) {  
72.         HeaderViewHolder holder;  
73.         if (convertView == null) {  
74.             holder = new HeaderViewHolder();  
75.             convertView = inflater.inflate(R.layout.proj_plans_header, parent, false);  
76.             holder.text = (TextView) convertView.findViewById(R.id.text1);  
77.             convertView.setTag(holder);  
78.         } else {  
79.             holder = (HeaderViewHolder) convertView.getTag();  
80.         }  
81.         //set proj_plans_header text as first char in name  
82.         String headerText = this.mPlanDetails.get(position).getProject_title();  
83.         holder.text.setText(headerText);  
84.         return convertView;  
85.     }  
86.   
87.     @Override  
88.     public long getHeaderId(int position) {  
89.         //return the first character of the country as ID because this is what headers are based upon  
90.         return Long.parseLong(this.mPlanDetails.get(position).getProj_id());  
91.     }  
92.   
93.     class HeaderViewHolder {  
94.         TextView text;  
95.     }  
96.   
97.     class ViewHolder {  
98.         ImageView img_plan;  
99.   
100.         TextView text_plan_name;  
101.   
102.         TextView text_plan_info;  
103.     }  
104. }  

  适配器是List数据显示最重要的部分，为了实现数据分组，该适配器必须要实现StickyListHeadersAdapter接口，并重写其中的getHeaderView(int position, View convertView, ViewGroup parent);和long getHeaderId(int position);方法。 

  说明：

     getHeaderView方法指定了Header的View的显示；

     getHeaderId决定header出现的时机，如果当前的headerid和前一个headerid不同时，就会显示。

4. 定义数据显示的Activity：

[java]  view plain  copy

 print ?

1. import android.app.Activity;  
2. import android.os.Bundle;  
3. import android.util.Log;  
4. import android.view.View;  
5. import android.widget.AdapterView;  
6.   
7. import java.util.ArrayList;  
8. import java.util.List;  
9.   
10. import se.emilsjolander.stickylistheaders.StickyListHeadersListView;  
11.   
12. public class MainActivity extends Activity {  
13.   
14.     public StickyListHeadersListView list;  
15.   
16.     private LangyaAdapter langyaAdapter;  
17.   
18.     private List<LangyaSimple> mLangyaDatas;  
19.   
20.     @Override  
21.     protected void onCreate(Bundle savedInstanceState) {  
22.         super.onCreate(savedInstanceState);  
23.         setContentView(R.layout.activity_main);  
24.   
25.         list = (StickyListHeadersListView) findViewById(R.id.list);  
26.         mLangyaDatas = new ArrayList<LangyaSimple>();  
27.   
28.         initDatas();  
29.   
30.         list.setOnItemClickListener(new OnPlanItemClick());  
31.         list.setOnItemLongClickListener(new OnPlanItemLongClick());  
32.   
33.         langyaAdapter = new LangyaAdapter(this, mLangyaDatas);  
34.         list.setAdapter(langyaAdapter);  
35.   
36.     }  
37.   
38.     private void updateData() {  
39.   
40.         if (langyaAdapter != null && mLangyaDatas != null) {  
41.   
42.             langyaAdapter.notifyDataSetChanged();  
43.         }  
44.     }  
45.   
46.     private class OnPlanItemClick implements AdapterView.OnItemClickListener {  
47.   
48.         @Override  
49.         public void onItemClick(AdapterView<?> parent, View view, int position, long id) {  
50.             LangyaSimple oLangyaSimple = (LangyaSimple) parent.getAdapter().getItem(  
51.                     position);  
52.             Log.e("tag", oLangyaSimple.toString());  
53.         }  
54.     }  
55.   
56.     private class OnPlanItemLongClick implements AdapterView.OnItemLongClickListener {  
57.   
58.         @Override  
59.         public boolean onItemLongClick(AdapterView<?> parent, View view, int position, long id) {  
60.   
61.             LangyaSimple oLangyaSimple = mLangyaDatas.get(position);  
62.   
63.             Log.e("tag", oLangyaSimple.toString());  
64.   
65.             mLangyaDatas.remove(oLangyaSimple);  
66.   
67.             updateData();  
68.   
69.             return true;  
70.         }  
71.     }  
72.   
73.     private void initDatas() {  
74.   
75.         mLangyaDatas.add(new LangyaSimple("1", "1", "无缘公子", "无缘公子无缘公子无缘公子无缘公子", "公子榜"));  
76.         mLangyaDatas.add(new LangyaSimple("2", "1", "无请公子", "无请公子无请公子无请公子无请公子", "公子榜"));  
77.         mLangyaDatas.add(new LangyaSimple("3", "1", "无名公子", "无名公子无名公子无名公子无名公子", "公子榜"));  
78.         mLangyaDatas.add(new LangyaSimple("4", "1", "无非公子", "无非公子无非公子无非公子无非公子", "公子榜"));  
79.         mLangyaDatas.add(new LangyaSimple("5", "1", "无能公子", "无能公子无能公子无能公子无能公子", "公子榜"));  
80.   
81.         mLangyaDatas.add(new LangyaSimple("6", "2", "最无情", "最无情最无情最无情最无情最无情", "高手榜"));  
82.         mLangyaDatas.add(new LangyaSimple("7", "2", "最无情", "最无情最无情最无情最无情最无情", "高手榜"));  
83.         mLangyaDatas.add(new LangyaSimple("8", "2", "最无情", "最无情最无情最无情最无情最无情", "高手榜"));  
84.         mLangyaDatas.add(new LangyaSimple("9", "2", "最无情", "最无情最无情最无情最无情最无情", "高手榜"));  
85.         mLangyaDatas.add(new LangyaSimple("10", "2", "最无情", "最无情最无情最无情最无情最无情", "高手榜"));  
86.   
87.         mLangyaDatas.add(new LangyaSimple("11", "3", "情殇", "情殇情殇情殇情殇情殇情殇情殇", "美人榜"));  
88.         mLangyaDatas.add(new LangyaSimple("12", "3", "情殇", "情殇情殇情殇情殇情殇情殇情殇", "美人榜"));  
89.         mLangyaDatas.add(new LangyaSimple("13", "3", "情殇", "情殇情殇情殇情殇情殇情殇情殇", "美人榜"));  
90.         mLangyaDatas.add(new LangyaSimple("14", "3", "情殇", "情殇情殇情殇情殇情殇情殇情殇", "美人榜"));  
91.         mLangyaDatas.add(new LangyaSimple("15", "3", "情殇", "情殇情殇情殇情殇情殇情殇情殇", "美人榜"));  
92.     }  
93. }  

  该Activity实现了较多的方法，1. 数据显示， 2. 列表的单机事件， 3. 列表的长按事件， 4. 数据更新等；

有个地方需要着重说明，那就是在初始化数据时，数据必须proj_id必须按分组排列，即，不要将proj_id不同的数据参差着放在集合中，否则容易造成列表显示多组相同组名的数据。

  对StickyListHeadersListView其余的操作（点击、长按），和普通的ListView一致，包括在xml中设置的属性也是一致的。

  如此这般，便可实现上述的效果了！

源码下载地址（免费）：http://download.csdn.net/detail/zuiwuyuan/9274693