Popularity
5.5
Declining
Activity
0.0
Declining
482
24
41

Code Quality Rank: L5
Programming language: Swift
License: MIT License
Tags: UI     UITableView    
Latest version: v3.0.0

Hakuba alternatives and similar libraries

Based on the "UITableView" category.
Alternatively, view Hakuba alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of Hakuba or a related project?

Add another 'UITableView' Library

README

Hakuba

Platform Language License Issues

I want to slim down view controllers.

I want to manage tableview without the code of UITableViewDelegate and UITableViewDataSource.

That is why I created Hakuba.

( Hakuba is one of the most famous ski resorts in Japan. )

Features

  • Don't have to write the code for UITableViewDelegate and UITableViewDataSource protocols
  • Easy to manage your sections and cells (append/reset/insert/remove/update)
  • Support dynamic cell height from ios7
  • Don't have to worry about cell identifier
  • Handling cell selection by trailing closure
  • Easy to implement header/footer view (floating callback)
  • Support for creating cells from Nibs or Storyboards
  • Method chaining
  • Subscript
  • Support loadmore closure
  • Complete example
Quick example
// viewController swift file

hakuba = Hakuba(tableView: tableView)

let cellmodel = YourCellModel(title: "Title", des: "description") {
    println("Did select cell with title = \(title)")
}

hakuba[2]
    .append(cellmodel)  // append a new cell model into datasource
    .bump(.fade)        // show the cell of your cell model in the table view

hakuba[1]
    .remove(1...3)
    .bump(.Right)
// your cell swift file

class YourCellModel: CellModel {
    let title: String
    let des: String

    init(title: String, des: String, selectionHandler: @escaping (Cell) -> Void) {
        self.title = title
        self.des = des
        super.init(YourCell.self, selectionHandler: selectionHandler)
    }
}


class YourCell: Cell, CellType {
    typealias CellModel = YourCellModel

    @IBOutlet weak var titleLabel: UILabel!

    override func configure() {
        guard let cellmodel = cellmodel else {
            return
        }

        titleLabel.text = cellmodel.title
    }
}

Usage

  • Initilization
private lazy var hakuba = Hakuba(tableView: tableView)   
  • Section handling
let section = Section() // create a new section

// inserting
hakuba
    .insert(section, at: 1)
    .bump()

// removing
hakuba
    .remove(at: index)
    .bump(.left)

hakuba
    .remove(section)
    .bump()

hakuba
    .removeAll()
    .bump()

// handing section index by enum
enum YourSection: Int, SectionIndexType {
    case top
    case center
    case bottom

    static let count = 3
}

let topSection = hakuba[YourSection.top]
  • Cell handling
// 1. appending
hakuba[0]
    .append(cellmodel)  // append a cellmodel
    .bump(.fade)        // and bump with `Fade` animation

hakuba[1]
    .append(cellmodels) // append a list of cellmodes
    .bump(.left)                    

// by using section
let section = hakuba[YourSection.top]
section
    .append(cellmodel)
    .bump()

// 2. inserting
section
    .insert(cellmodels, at: 1)
    .bump(.middle)

// 3. reseting
section
    .reset(cellmodels)  // replace current data in section by the new data
    .bump()

section
    .reset()    // or remove all data in section
    .bump()

// 4. removing
section
    .remove(at: 1)
    .bump(.right)

section
    .remove(range: 2...5)
    .bump()

section
    .removeLast()
    .bump()
// updating cell data
let section = hakuba[YourSection.top]
section[1].property = newData
section[1]
    .bump()     
section.sort().bump()
section.shuffle().bump()
section.map
section.filter
section.reduce
section.mapFilter
section.each

section.first
section.last
section[1]
section.count
  • Register cell, header, footer
hakuba
    .registerCellByNib(CellClass.self)

hakuba
    .registerCell(CellClass.self)

hakuba
    .registerHeaderFooterByNib(HeaderOrFooterClass.self)

hakuba
    .registerHeaderFooter(HeaderOrFooterClass.self)

// register a list of cells by using variadic parameters
hakuba.registerCellByNibs(CellClass1.self, CellClass2.self, ..., CellClassN.self)
  • Section header/footer
let header = HeaderFooterViewModel(view: CustomHeaderView) {
    println("Did select header view")
}
hakuba[Section.top].header = header
  • Loadmore
hakuba.loadmoreEnabled = true
hakuba.loadmoreHandler = {
    // request api
    // append new data
}
  • Commit editing
hakuba.commitEditingHandler = { [weak self] style, indexPath in
self?.hakuba[indexPath.section]
    .remove(indexPath.row)
}
  • Deselect all cells
hakuba.deselectAllCells(animated: true)
  • Callback methods in the cell class
func willAppear(data: CellModel)
func didDisappear(data: CellModel)

Installation

  • Installation with CocoaPods
pod 'Hakuba'
  • Copying all the files into your project
  • Using submodule

Requirements

  • iOS 9.0+
  • Xcode 9+
  • Swift 4

License

Hakuba is released under the MIT license. See LICENSE for details.


*Note that all licence references and agreements mentioned in the Hakuba README section above are relevant to that project's source code only.