xiaoyanit / simple-section-adapter Goto Github PK

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.

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

• Android 1.6 and up

// 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.

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…
}

• Can I use SimpleSectionAdapter with ArrayAdapter or CursorAdapter?
  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?
  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?
  No, you don't have to include anything besides the SimpleSectionAdapter and the Sectionizer.