Separating Lists with Headers

 

Separating Lists with Headers in Android 0.9

Monday August 18, 2008 at 4:42 PM

 Earlier today the latest Android 0.9 SDK was released, and it’s packed full of wonderful changes. As you play around, you might see ListViews split into sections using separating headers. (Example shown on the right is the browser settings list.)

There isn’t an easy way of creating these separated lists, so I’ve put together SeparatedListAdapter which does it quickly. To summarize, we’re creating a new BaseAdapter that can contain several other Adapters, each with their own section headers.

First let’s create some simple XML layouts to be used for our lists: first the header view, then two item views that we’ll use later for the individual lists. (Thanks to Romain Guy for helping me find existing styles to keep these XML layouts nice and tidy.)

view plain copy to clipboard print ?

1.  
2. <TextView
3. xmlns:android="http://schemas.android.com/apk/res/android"
4. android:id="@+id/list_header_title"
5. android:layout_width="fill_parent"
6. android:layout_height="wrap_content"
7. android:paddingTop="2dip"
8. android:paddingBottom="2dip"
9. android:paddingLeft="5dip"
10. style="?android:attr/listSeparatorTextViewStyle" />
12.  
13. <TextView
14. xmlns:android="http://schemas.android.com/apk/res/android"
15. android:id="@+id/list_item_title"
16. android:layout_width="fill_parent"
17. android:layout_height="fill_parent"
18. android:paddingTop="10dip"
19. android:paddingBottom="10dip"
20. android:paddingLeft="15dip"
21. android:textAppearance="?android:attr/textAppearanceLarge"
22. />
24.  
25. <LinearLayout
26. xmlns:android="http://schemas.android.com/apk/res/android"
27. android:layout_width="fill_parent"
28. android:layout_height="wrap_content"
29. android:orientation="vertical"
30. android:paddingTop="10dip"
31. android:paddingBottom="10dip"
32. android:paddingLeft="15dip"
33. >
34. <TextView
35. android:id="@+id/list_complex_title"
36. android:layout_width="fill_parent"
37. android:layout_height="wrap_content"
38. android:textAppearance="?android:attr/textAppearanceLarge"
39. />
40. <TextView
41. android:id="@+id/list_complex_caption"
42. android:layout_width="fill_parent"
43. android:layout_height="wrap_content"
44. android:textAppearance="?android:attr/textAppearanceSmall"
45. />
46. LinearLayout>

Now let’s create the actual SeparatedListAdapter class which provides a single interface to multiple sections of other Adapters. After using addSection() to construct the child sections, you can easily use ListView.setAdapter() to present the now-separated list to users.

As for the Adapter internals, to correctly find the selected item among the child Adapters, we walk through subtracting from the original position until we find either a header (position = 0) or item in the current child Adapter (position <>

Here’s the source for SeparatedListAdapter:

view plain copy to clipboard print ?

1. public class SeparatedListAdapter extends BaseAdapter {
3. public final Map sections = new LinkedHashMap();
4. public final ArrayAdapter headers;
5. public final static int TYPE_SECTION_HEADER = 0;
7. public SeparatedListAdapter(Context context) {
8. headers = new ArrayAdapter(context, R.layout.list_header);
9. }
11. public void addSection(String section, Adapter adapter) {
12. this.headers.add(section);
13. this.sections.put(section, adapter);
14. }
16. public Object getItem(int position) {
17. for(Object section : this.sections.keySet()) {
18. Adapter adapter = sections.get(section);
19. int size = adapter.getCount() + 1;
21. // check if position inside this section
22. if(position == 0) return section;
23. if(position <>return adapter.getItem(position - 1);
25. // otherwise jump into next section
26. position -= size;
27. }
28. return null;
29. }
31. public int getCount() {
32. // total together all sections, plus one for each section header
33. int total = 0;
34. for(Adapter adapter : this.sections.values())
35. total += adapter.getCount() + 1;
36. return total;
37. }
39. public int getViewTypeCount() {
40. // assume that headers count as one, then total all sections
41. int total = 1;
42. for(Adapter adapter : this.sections.values())
43. total += adapter.getViewTypeCount();
44. return total;
45. }
47. public int getItemViewType(int position) {
48. int type = 1;
49. for(Object section : this.sections.keySet()) {
50. Adapter adapter = sections.get(section);
51. int size = adapter.getCount() + 1;
53. // check if position inside this section
54. if(position == 0) return TYPE_SECTION_HEADER;
55. if(position <>return type + adapter.getItemViewType(position - 1);
57. // otherwise jump into next section
58. position -= size;
59. type += adapter.getViewTypeCount();
60. }
61. return -1;
62. }
64. public boolean areAllItemsSelectable() {
65. return false;
66. }
68. public boolean isEnabled(int position) {
69. return (getItemViewType(position) != TYPE_SECTION_HEADER);
70. }
72. @Override
73. public View getView(int position, View convertView, ViewGroup parent) {
74. int sectionnum = 0;
75. for(Object section : this.sections.keySet()) {
76. Adapter adapter = sections.get(section);
77. int size = adapter.getCount() + 1;
79. // check if position inside this section
80. if(position == 0) return headers.getView(sectionnum, convertView, parent);
81. if(position <>return adapter.getView(position - 1, convertView, parent);
83. // otherwise jump into next section
84. position -= size;
85. sectionnum++;
86. }
87. return null;
88. }
90. @Override
91. public long getItemId(int position) {
92. return position;
93. }
95. }