9.1 问题
需要创建一个有若干节内容的列表，其中每一节的顶部都有各自的头部。
9.2 解决方案
（API Level 1）
我们可以通过构建自定义列表适配器来实现此效果，此适配器利用了对多种视图类型的支持。适配器依赖getViewTypeCount()和getItemViewType()来确定将多少种视图用作列表中的行。在大多数情况下，如果所有的行类型相同，就忽略上述方法。然而，在此可以使用这些方法回调为头部行和内容行定义独特的类型。
9.3 实现机制
下图显示了带有节头部的示例列表的预览效果。
分节的列表
我们首先在以下代码中定义SectionItem数据结构，用于表示列表中的每一节。此项将保存节标题以及此标题下列出的数据数组子集。
包含每一节数据的结构
public class SectionItem<T> {
private String mTitle;
private T[] mItems;
public SectionItem(String title, T[] items) {
if (title == null) title = "";
mTitle = title;
mItems = items;
}
public String getTitle() {
return mTitle;
}
public T getItem(int position) {
return mItems[position];
}
public int getCount() {
//为节标题包含额外的项
return (mItems == null ? 1 : 1 + mItems.length);
}
@Override
public boolean equals(Object object) {
//如果两个节有相同的标题，则它们相等
if (object != null && object instanceof SectionItem) {
return ((SectionItem) object).getTitle().equals(mTitle);
}
return false;
}
}
此结构将使列表适配器中的逻辑更易于管理。在以下代码中，我们可以看到提供分节列表视图的适配器。此适配器的任务是将每个节项（包括它们的头部）的位置映射到适配器视图（如ListView）所了解的可见列表的全局位置。
用于显示多个节的ListAdapter
public abstract class SimpleSectionsAdapter<T> extends BaseAdapter implements AdapterView.OnItemClickListener {
/* 为每个视图类型定义常量 */
private static final int TYPE_HEADER = 0;
private static final int TYPE_ITEM = 1;
private LayoutInflater mLayoutInflater;
private int mHeaderResource;
private int mItemResource;
/* 所有节的唯一聚合*/
private List<SectionItem<T>> mSections;
/* 节的分组，按其初始位置设置键 */
private SparseArray<SectionItem<T>> mKeyedSections;
public SimpleSectionsAdapter(ListView parent, int headerResId, int itemResId) {
mLayoutInflater = LayoutInflater.from(parent.getContext());
mHeaderResource = headerResId;
mItemResource = itemResId;
//创建包含自动排序键的集合
mSections = new ArrayList<SectionItem<T>>();
mKeyedSections = new SparseArray<SectionItem<T>>();
//将自身附加为列表的单击处理程序
parent.setOnItemClickListener(this);
}
/*
*向列表添加新的带标题的节，
* 或者更新现有的节
*/
public void addSection(String title, T[] items) {
SectionItem<T> sectionItem = new SectionItem<T>(title, items);
//添加节，替换具有相同标题的现有节
int currentIndex = mSections.indexOf(sectionItem);
if (currentIndex >= 0) {
mSections.remove(sectionItem);
mSections.add(currentIndex, sectionItem);
} else {
mSections.add(sectionItem);
}
//对最新的集合排序
reorderSections();
//表明视图数据已改变
notifyDataSetChanged();
}
/*
* 将带有初始全局位置的节标记为可引用的键
*/
private void reorderSections() {
mKeyedSections.clear();
int startPosition = 0;
for (SectionItem<T> item : mSections) {
mKeyedSections.put(startPosition, item);
//此计数包括头部试图
startPosition += item.getCount();
}
}
@Override
public int getCount() {
int count = 0;
for (SectionItem<T> item : mSections) {
//添加项的计数
count += item.getCount();
}
return count;
}
@Override
public int getViewTypeCount() {
//两种视图类型：头部和项
return 2;
}
@Override
public int getItemViewType(int position) {
if (isHeaderAtPosition(position)) {
return TYPE_HEADER;
} else {
return TYPE_ITEM;
}
}
@Override
public T getItem(int position) {
return findSectionItemAtPosition(position);
}
@Override
public long getItemId(int position) {
return position;
}
/*
*重写并返回false，告诉ListView有一些项（头部）不可点击
*/
@Override
public boolean areAllItemsEnabled() {
return false;
}
/*
* 重写以告诉 ListView 哪些项(头部)是不可点击的
*/
@Override
public boolean isEnabled(int position) {
return !isHeaderAtPosition(position);
}
@Override
public View getView(int position, View convertView, ViewGroup parent) {
switch (getItemViewType(position)) {
case TYPE_HEADER:
return getHeaderView(position, convertView, parent);
case TYPE_ITEM:
return getItemView(position, convertView, parent);
default:
return convertView;
}
}
private View getHeaderView(int position, View convertView, ViewGroup parent) {
if (convertView == null) {
convertView = mLayoutInflater.inflate(mHeaderResource, parent, false);
}
SectionItem<T> item = mKeyedSections.get(position);
TextView textView = (TextView) convertView.findViewById(android.R.id.text1);
textView.setText(item.getTitle());
return convertView;
}
private View getItemView(int position, View convertView, ViewGroup parent) {
if (convertView == null) {
convertView = mLayoutInflater.inflate(mItemResource, parent, false);
}
T item = findSectionItemAtPosition(position);
TextView textView = (TextView) convertView.findViewById(android.R.id.text1);
textView.setText(item.toString());
return convertView;
}
/** OnItemClickListener 方法*/
@Override
public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
T item = findSectionItemAtPosition(position);
if (item != null) {
onSectionItemClick(item);
}
}
/**
*重写方法以处理特定元素的单击事件，即用户单击的@param 项列表项
*/
public abstract void onSectionItemClick(T item);
/*用于将项映射到节的辅助方法 */
/*
* 检查是否是代表节标题的全局位置值
*/
private boolean isHeaderAtPosition(int position) {
for (int i=0; i < mKeyedSections.size(); i++) {
//如果此位置是键值，则它就是头部位置
if (position == mKeyedSections.keyAt(i)) {
return true;
}
}
return false;
}
/*
* 返回给定全局位置的显示列表项
*/
private T findSectionItemAtPosition(int position) {
int firstIndex, lastIndex;
for (int i=0; i < mKeyedSections.size(); i++) {
firstIndex = mKeyedSections.keyAt(i);
lastIndex = firstIndex + mKeyedSections.valueAt(i).getCount();
if (position >= firstIndex && position < lastIndex) {
int sectionPosition = position - firstIndex - 1;
return mKeyedSections.valueAt(i).getItem(sectionPosition);
}
}
return null;
}
}
SimpleSectionsAdapter通过getViewTypeCount返回2，这样我们就可以分别支持头部视图和内容视图。我们需要为每个视图提供独特的类型标识符，内部列表将这些值用作索引，因此它们应始终从0开始并递增，从TYPE_HEADER和TYPE_ITEM常量中可以看出这一点。
我们通过addSection()方法将数据按节提供给此适配器，该方法接受的参数是节标题和此部分的项的数组。适配器使每个节标题仅出现一次，因此每次尝试添加新的节都会删除具有相同标题的现有节。
添加新的节时，列举所有的节以确定它们的全局开始位置是否在列表内。为了在后面进行更快速的访问，在SparseArray中将这些值存储为键。此集合将用于搜索给定位置的节。最后，每个节改动需要我们调用notifyDataSetChanged()，该方法告诉视图需要再次查询适配器的并刷新显示。
通过对每个节的计数求和来确定所有项的计数。这包括头部视图，列表将其与其他行同等对待。这在传统上意味着这些项也是可交互的，会将单击事件传送给附加的侦听器。我们不需要头部的此行为，因此还必须重写areAllItemsEnabled()和isEnabled()方法，向视图表明这些头部应是不可交互的。
在getView()方法内部，我们传递一个视图类型，该视图类型用于确定应返回何种类型的视图。我们知道，对于TYPE_HEADER需要返回设置了标题文本的头部行。对于TYPE_ITEM，我们返回显示正确项的内容行。Android框架通过实现getItemViewType()了解在每个位置应存在何种视图类型，该方法将位置与类型标识符进行关联。我们创建了简单的isHeaderAtPosition()方法来做出决定。通过检查给定位置是否与某个节键匹配（这使其成为节中的第一个位置，即头部），我们可以快速确定类型。
获得每个项的视图之后，我们必须确定给定位置的节。另一个辅助方法findSectionItemAtPosition()通过根据前面计算出来的节键验证位置来执行此搜索。在用户点击项时，我们也利用此方法将项自身返回给侦听器，而不是仅返回位置值。在简单列表中，可能只需要位置就能找到正确的数据，但采用位置映射之后，侦听器就可以更轻松地直接获得所需的项。
我们已将此适配器定义为抽象类型，这只需要应用程序实现为列表项单击事件提供处理程序。以下两段代码显示了如何将此适配器与数据绑定并显示在Activity中。
res/layout/list_header.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:padding="8dp"
android:background="#CCF">
<TextView
android:id="@android:id/text1"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
</LinearLayout>
显示分节列表的Activity
public class SectionsActivity extends ActionBarActivity {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
ListView list = new ListView(this);
SimpleSectionsAdapter<String> adapter = new SimpleSectionsAdapter<String>(
list, /*资源扩充的上下文 */
R.layout.list_header, /* 头部视图的布局*/
android.R.layout.simple_list_item_1 /* Layout for item views */
) {
//适用于项点击的单击处理程序
@Override
public void onSectionItemClick(String item) {
Toast.makeText(SectionsActivity.this, item, Toast.LENGTH_SHORT).show();
}
};
adapter.addSection("Fruits", new String[]{"Apples", "Oranges", "Bananas", "Mangos"});
adapter.addSection("Vegetables", new String[]{"Carrots", "Peas", "Broccoli"});
adapter.addSection("Meats", new String[]{"Pork", "Chicken", "Beef", "Lamb"});
list.setAdapter(adapter);
setContentView(list);
}
}
在Activity内部，建立ListView以显示3个节：水果、蔬菜和肉类。SimpleSectionsAdapter获取布局的两个资源ID，适配器应该为头部和内容扩充这些布局。此例中的头部布局是居中显示单个TextView的自定义布局，而内容布局是框架中的标准布局（android.R.id.simple_list_item_1）。因为适配器是抽象的，我们需要提供onSectionClick()的定义，在本例中，该定义仅在Toast中显示所选项的名称。
网友评论