GCRetractableSectionController

Controller that helps the management of UITableViews extendable sections

OTHER License

Stars
338

h1. GCRetractableSectionController

GCRetractableSectionController is an helper class that let you make easily section of @UITableView@ that detract and contract when tapped.

!http://s3.amazonaws.com/cocoacontrols_production/ios_screens/97/full.png?1303498477!

h2. Usage

(See the demo project included)

h3. Creation and customization

First thing you need to do is subclass @GCRetractableSectionController@ to have your own section controller. (You can also look at @GCArraySectionController@, a drop-in subclass that you can use right away, available in the demo project.)

The basics things you need to overwrite are the following.

The @title@ property represent the title of the section. The @title@ is shown in the main cell when the section controller is closed. The @contentNumberOfRow@ should return the number of rows of content in your section (the title cell is not content). You also overwrite @titleContentForRow:@ to provide the title of your content cells.

See the @GCSimpleSectionController@ example in the demo project.

To react to selection of your content, you should overwrite in your section controller this method.

You can also change have more control on the content of your cells by overwriting the following methods. Look at the @GCCustomSectionController@ in the demo project for more details.

h3. UITableView's dataSource usage

When your @GCRetractableSectionController@ is ready, you need to use it in your @UIViewController@.

You initialize your subclass by providing your @UIViewController@. You @UIViewController@ must respond to the 'tableView' selector and return a @UITableView@. You'll probably want to save that section controller as an ivar.

@GCRetractableSectionController@ provide simple method for you to use in you @UITableView@ 's dataSource. An example usage follow.

Related Projects