Awesome Open Source
Awesome Open Source


CI Status Version License Platform


To run the example project, clone the repo, and run pod install from the Example directory first. Then run ABExpandableView.xcworkspace which is under /Example folder.


  • Swift 4
  • Xcode 9


ABExpandableView is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'ABExpandableView'


First, import ABExpandableView to your project.

You should have 2 kinds of model objects to use this view that one of them should be section and the other one should be row.

Consider, Section and Row classes are your objects.

class Section: SectionItem {
    var identifier: String!
    var name: String!
    var expanded: Bool = true
    var rows: [RowItem] = [RowItem]()
    var rawRows: [RowItem] = [RowItem]() {
        didSet {
            rows = rawRows
    var selectedRows: [RowItem] = [RowItem]()

class Row: RowItem {
    var identifier: String!
    var name: String!

class MockDataProvider {
    class func createMockData() -> [SectionItem] {
        var array = [SectionItem]()
        let izmir = City()
        izmir.identifier = "35" = "İzmir"
        let bornova = Town(identifier: "1", name: "Bornova")
        let urla = Town(identifier: "2", name: "Urla")
        let konak = Town(identifier: "3", name: "Konak")
        let izmirRawRows = [bornova, urla, konak]
        izmir.rawRows = izmirRawRows
        let istanbul = City()
        istanbul.identifier = "34" = "İstanbul"
        let kadikoy = Town(identifier: "4", name: "Kadıköy")
        let maltepe = Town(identifier: "5", name: "Maltepe")
        let beykoz = Town(identifier: "6", name: "Beykoz")
        let istanbulRawRows = [kadikoy, maltepe, beykoz]
        istanbul.rawRows = istanbulRawRows
        return array

After you create your models, you should open ABExpandableView with injecting those model array.

@IBAction func buttonTapped(_ sender: Any) {
        let cities = MockDataProvider.createMockData()
        let expandableSectionsViewModel = ExpandableSectionsViewModel(cities)
        let expandableSectionViewController = ExpandableSectionsViewController.newInstance(expandableSectionsViewModel)
        expandableSectionViewController.title = "Choose Town(s)"
        expandableSectionViewController.delegate = self
        self.navigationController?.pushViewController(expandableSectionViewController, animated: true)

Here, let ABExpandableView handle the rest.

One last thing; You can get selected items using the delegation;

    func didSelectItems(_ items: [RowItem]) {
        let names = items.flatMap { $ }.joined(separator: ", ")
        // "Bornova, Kadıköy"


alicanbatur, [email protected]


ABExpandableView is available under the MIT license. See the LICENSE file for more info.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Swift (95,353
Ios (19,243
Ui (5,263
Mvvm (2,558
Cocoapods (1,971
Cocoapods (1,971
Ui Components (1,681
Swift4 (1,490
Protocol (1,258
Pod (390
Tableview (316
Related Projects