Секционный список в Android

Списки, разделённые на секции, встречаются довольно часто как в системных приложениях, так и в сторонних. Но, как ни странно, платформа не предлагает способов для их реализации «из коробки», в отличие от iOS.


Мне известны два подхода к реализации заголовков списков:

• В вёрстке каждого элемента списка прописывается заголовок, видимость которого будет определяться условием «является ли данный элемент первым в секции?»
• Отдельно верстается заголовок для списка, а в методе Adapter#getView идёт выбор: создавать элемент типа «заголовок», либо элемент типа «обычная строка»

Первый способ проще с точки зрения написания кода: не надо задумываться о выборе типа ячейки списка. Но влечёт за собой более «тяжёлый», с точки зрениния производительности, интерфейс. Второй — чуть более громоздкий в реализации, но немного быстрее и, что самое главное, позволяет использовать системные вёрстки.
В данной статье используется второй подход.

Базовый класс адаптера

Базовый адаптер берёт на себя ответственность за определение типа строки списка, взамен просит своих наследников уметь создавать заголовки и строки с данными:

    protected abstract int getSectionsCount( );
    protected abstract int getRowsCountInSection( int section );
    protected abstract View getHeaderView( int section, View convertView, 
        ViewGroup parent, LayoutInflater inflater );
    protected abstract View getItemView( int section, int row, View convertView, 
        ViewGroup parent, LayoutInflater inflater );

Далее, при изменении данных в списке (при вызове notifyDataSetChanged), мы считаем общее количество строк в списке, кешируем количество элементов в каждой секции, количество разных типов строк списка и связь этих типов с секциями:

    private void setupAdapter( ) {
        int sectionsCount = getSectionsCount();
        _rowsCountsInSections = new int [sectionsCount];
        _viewTypes = new int [sectionsCount];

        _totalRowsCount = sectionsCount;
        Set<Integer> viewTypesSet = new HashSet<Integer>();
        for (int i = 0; i < sectionsCount; i++) {
            _rowsCountsInSections[i] = getRowsCountInSection(i);
            _totalRowsCount += _rowsCountsInSections[i];
            _viewTypes[i] = getViewTypeForSection(i);
            viewTypesSet.add(_viewTypes[i]);
        }

        viewTypesSet.add(VIEW_TYPE_HEADER);
        _viewTypesCount = viewTypesSet.size();
    }

На основе собранной информации можно без особых проблем выбрать, что нам нужно создавать в getView:

    @Override
    final public View getView( int position, View convertView, ViewGroup parent ) {
        int section = getItemSection(position);

        if (isItemHeader(position))
            return getHeaderView(section, convertView, parent, _inflater);

        int rowInSection = getItemRowInSection(position);
        return getItemView(section, rowInSection, convertView, parent, _inflater);
    }

Определяем, является ли строка заголовком или элементом секции, так:

    private boolean isItemHeader( int position ) {
        int sum = 0;
        for (int i = 0; i < _rowsCountsInSections.length && sum <= position; i++) {
            if (sum == position)
                return true;

            sum += _rowsCountsInSections[i] + 1;
        }

        return false;
    }

    private int getItemSection( int position ) {
        int sum = 0;
        int section = 0;
        while (sum <= position && section < _rowsCountsInSections.length)
            sum += _rowsCountsInSections[section++] + 1;

        return section - 1;
    }

    private int getItemRowInSection( int position ) {
        int section = getItemSection(position);
        int sum = 0;
        for (int i = 0; i < section; i++)
            sum += _rowsCountsInSections[i] + 1;

        return position - sum - 1;
    }

В принципе, методы получения номера секции и индекса внутри секции можно объединить в один, разделение оставлено для наглядности.
Базовый класс целиком:

abstract public class BaseSectionedListAdapter extends BaseAdapter {
    private static int VIEW_TYPE_HEADER = 0;
    protected static int VIEW_TYPE_DATA = 1;

    final private LayoutInflater _inflater;
    private int _totalRowsCount = -1;
    private int [] _rowsCountsInSections;
    private int [] _viewTypes;
    private int _viewTypesCount;

    public BaseSectionedListAdapter( Context context ) {
        _inflater = LayoutInflater.from(context);
    }

    @Override
    final public int getCount( ) {
        if (_totalRowsCount == -1)
            setupAdapter();

        return _totalRowsCount;
    }

    @Override
    final public Object getItem( int position ) {
        return null;
    }

    @Override
    final public long getItemId( int position ) {
        return position;
    }

    @Override
    final public View getView( int position, View convertView, ViewGroup parent ) {
        int section = getItemSection(position);

        if (isItemHeader(position))
            return getHeaderView(section, convertView, parent, _inflater);

        int rowInSection = getItemRowInSection(position);
        return getItemView(section, rowInSection, convertView, parent, _inflater);
    }

    @Override
    public int getItemViewType( int position ) {
        if (isItemHeader(position))
            return VIEW_TYPE_HEADER;

        int section = getItemSection(position);
        return _viewTypes[section];
    }

    @Override
    public int getViewTypeCount( ) {
        return _viewTypesCount;
    }

    @Override
    public boolean isEnabled( int position ) {
        return !isItemHeader(position);
    }

    @Override
    final public boolean areAllItemsEnabled( ) {
        return false;
    }

    @Override
    final public void notifyDataSetChanged( ) {
        super.notifyDataSetChanged();
        setupAdapter();
    }

    @Override
    public boolean hasStableIds( ) {
        return true;
    }

    private boolean isItemHeader( int position ) {
        int sum = 0;
        for (int i = 0; i < _rowsCountsInSections.length && sum <= position; i++) {
            if (sum == position)
                return true;

            sum += _rowsCountsInSections[i] + 1;
        }

        return false;
    }

    private int getItemSection( int position ) {
        int sum = 0;
        int section = 0;
        while (sum <= position && section < _rowsCountsInSections.length)
            sum += _rowsCountsInSections[section++] + 1;

        return section - 1;
    }

    private int getItemRowInSection( int position ) {
        int section = getItemSection(position);
        int sum = 0;
        for (int i = 0; i < section; i++)
            sum += _rowsCountsInSections[i] + 1;

        return position - sum - 1;
    }

    private void setupAdapter( ) {
        int sectionsCount = getSectionsCount();
        _rowsCountsInSections = new int [sectionsCount];
        _viewTypes = new int [sectionsCount];

        _totalRowsCount = sectionsCount;
        Set<Integer> viewTypesSet = new HashSet<Integer>();
        for (int i = 0; i < sectionsCount; i++) {
            _rowsCountsInSections[i] = getRowsCountInSection(i);
            _totalRowsCount += _rowsCountsInSections[i];
            _viewTypes[i] = getViewTypeForSection(i);
            viewTypesSet.add(_viewTypes[i]);
        }

        viewTypesSet.add(VIEW_TYPE_HEADER);
        _viewTypesCount = viewTypesSet.size();
    }

    protected int getViewTypeForSection( int section ) {
        return VIEW_TYPE_DATA;
    }

    protected abstract int getSectionsCount( );
    protected abstract int getRowsCountInSection( int section );
    protected abstract View getHeaderView( int section, View convertView,
        ViewGroup parent, LayoutInflater inflater );
    protected abstract View getItemView( int section, int row, View convertView,
        ViewGroup parent, LayoutInflater inflater );
}

Пример использования

Простой пример: на вход подаём список «секций», рисуем все данные секций одним стилем.
Секция представляет название заголовка и набор данных:

final public class SimpleSection {
    final private String _title;
    final private List<?> _data;

    public SimpleSection( String title, List<?> data ) {
        _title = title;
        _data = data;
    }

    public String getTitle( ) {
        return _title;
    }

    public List<?> getData( ) {
        return _data;
    }
}

Для заголовка используется простейшая вёрстка, состаящая из одного TextView:

<TextView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@android:id/text1"
    android:layout_width="match_parent"
    android:layout_height="30dp"
    android:textAppearance="?android:attr/textAppearanceSmallInverse"
    android:gravity="center_vertical"
    android:paddingLeft="6dip"
    android:background="@android:color/black"
/>

Простой адаптер целиком:

final public class SimpleSectionedListAdapter extends BaseSectionedListAdapter {
    final private List<SimpleSection> _sections;

    public SimpleSectionedListAdapter( Context context, List<SimpleSection> sections ) {
        super(context);
        _sections = sections;
    }

    @Override
    protected int getSectionsCount( ) {
        return _sections.size();
    }

    @Override
    protected int getRowsCountInSection( int section ) {
        return _sections.get(section).getData().size();
    }

    @Override
    protected View getHeaderView( int section, View convertView, ViewGroup parent, LayoutInflater inflater ) {
        if (convertView == null)
            convertView = inflater.inflate(R.layout.list_header, parent, false);

        TextView text = (TextView)convertView;
        text.setText(_sections.get(section).getTitle());

        return convertView;
    }

    protected Object getItemInSection( int section, int row ) {
        return _sections.get(section).getData().get(row);
    }

    @Override
    protected View getItemView( int section, int row, View convertView, ViewGroup parent, LayoutInflater inflater ) {
        Object item = getItemInSection(section, row);
        if (convertView == null)
            convertView = inflater.inflate(android.R.layout.simple_list_item_1, parent, false);

        TextView text = (TextView)convertView;
        text.setText(item.toString());

        return convertView;
    }
}

Итого

Если натравить на приведённый выше адаптер некоторый набор данных, то можно будет получить что-то похожее на (если поиграться с getViewTypeForSection, то легко получаем вторую картинку):

Приветствуются любые комментарии, пожелания, а также ругательства относительно стиля кодирования.