Awesome

Notice

Simple Section Adapter is now part of an even more awesome Adapter Kit project!

About

This is the SIMPLEST Section Adapter available for Android's ListView. It works with list adapters that you already have. No project specific dependencies. Just include the latest jar or the sources to your Android project.

Pros

• The simplest implementation yet, you can create a sectioned ListView with just 6 lines of code.
• Zero project specific dependencies.

Compatibility

• Android 1.6 and up

Usage

// 1. Create a Sectionizer    
class BookSectionizer implements Sectionizer<Book> {

    @Override
    public String getSectionTitleForItem(Book book) {
        return book.getGenre();
    }
}

// 2. Wrap your existing adapter with the SimpleSectionAdapter
SimpleSectionAdapter<Book> sectionAdapter = new SimpleSectionAdapter<Book>(context, 
        yourBookAdapter, R.layout.section_header, R.id.title, 
        new BookSectionizer());
    
// 3. Set the SimpleSectionAdapter to your ListView
listView.setAdapter(sectionAdapter);

Also you can check a complete example for a quick start. The sources have a few more examples as well.

NOTE: The data source (Cursor, ArrayList or Array) provided to your Adapter should be sorted in a logical way you want them to be sectioned. For instance, if you want to section your books by genres, they have to be sorted by genres before you wrap it within the SimpleSectionAdapter.

Screenshots

<img src="http://mobsandgeeks.com/images/android/ssa-ss1.png">   <img src="http://mobsandgeeks.com/images/android/ssa-ss2.png">

OnItemClickListener

While using an OnItemClickListener instead of using the list item's position directly, use it as shown below.

@Override
public void onItemClick(AdapterView<?> parentView, View view, int position, long id) {
    // 1. You could do this
    City city = (City) sectionAdapter.getItem(position);
        
    // 2. Or you could do this :)
    int index = sectionAdapter.getIndexForPosition(position);
    City sameCity = cities.get(index);

    // More code…
}

FAQs

• Can I use SimpleSectionAdapter with ArrayAdapter or CursorAdapter? <br />Yes, you can use SimpleSectionAdapter with any adapter that extends BaseAdapter.

• Should I sort my data in my data source source (Cursor, ArrayList or Array) logically in the order they have to be sectioned? <br />Yes, you have to sort your data, SimpleSectionAdapter does not perform sorting.

• Are there any resource files that has to be included with my project? <br />No, you don't have to include anything besides the SimpleSectionAdapter and the Sectionizer.

License

Copyright 2012 Mobs and Geeks

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.