iOS Form

Implement iOS Form with UITableView

Create a base controller

class FormViewController: UIViewController {
 let tableView = UITableView(frame: .zero, style: .grouped)
 let dataSource = FormDataSource()
 override func viewDidLoad() {
 super.viewDidLoad()
 configure()
 }
}
// MARK: - UITableViewDataSource
extension FormViewController: UITableViewDataSource {
 func numberOfSections(in tableView: UITableView) -> Int {
 dataSource.sections.count
 }
 func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
 dataSource.sections[section].fields.count
 }
 func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
 let field = dataSource.sections[indexPath.section].fields[indexPath.row]
 return field.dequeue(for: tableView, at: indexPath)
 }
}
// MARK: - UITableViewDelegate
extension FormViewController: UITableViewDelegate {
 func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat {
 let field = dataSource.sections[indexPath.section].fields[indexPath.row]
 return field.height
 }
 func tableView(_ tableView: UITableView, viewForHeaderInSection section: Int) -> UIView? {
 dataSource.sections[section].header?.dequeue(for: tableView, in: section)
 }
 func tableView(_ tableView: UITableView, heightForHeaderInSection section: Int) -> CGFloat {
 guard let header = dataSource.sections[section].header else { return .zero }
 return header.height
 }
 func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
 let field = dataSource.sections[indexPath.section].fields[indexPath.row]
 field.tableView(tableView, didSelectRowAt: indexPath)
 }
}

Detail about FormDataSource

final class FormDataSource {
 private(set) var sections: [FormSection] = []
}

FormSection

final class FormSection {
 var key: String
 var header: FormHeader?
 var fields: [FormField]
 init(key: String, header: FormHeader? = nil, fields: [FormField]) {
 self.key = key
 self.header = header
 self.fields = fields
 }
}

FormHeader

import UIKit
protocol FormHeader: AnyObject {
 var key: String { get }
 var height: CGFloat { get }
 func register(for tableView: UITableView)
 func dequeue(for tableView: UITableView, in section: Int) -> UIView?
}

final class TitleFormHeader {
 let key: String
 let viewModel: TitleHeaderFooterViewModel
 init(key: String, viewModel: TitleHeaderFooterViewModel) {
 self.key = key
 self.viewModel = viewModel
 }
}
extension TitleFormHeader: FormHeader {
 var height: CGFloat { 60.0 }
 func register(for tableView: UITableView) {
 tableView.register(TitleHeaderFooterView.self, forHeaderFooterViewReuseIdentifier: "TitleHeaderFooterView")
 }
 func dequeue(for tableView: UITableView, in section: Int) -> UIView? {
 let view = tableView.dequeueReusableHeaderFooterView(
 withIdentifier: "TitleHeaderFooterView"
 ) as? TitleHeaderFooterView
 view?.configure(with: viewModel)
 return view
 }
}

FormField

protocol FormField: AnyObject {
 var key: String { get }
 var height: CGFloat { get }
 var delegate: FormFieldDelegate? { get set }
 func register(for tableView: UITableView)
 func dequeue(for tableView: UITableView, at indexPath: IndexPath) -> UITableViewCell
 func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath)
}

final class TextInputFormField {
 let key: String
 var viewModel: TextInputViewModel
 weak var delegate: FormFieldDelegate?
 init(key: String, viewModel: TextInputViewModel) {
 self.key = key
 self.viewModel = viewModel
 }
}
// MARK: - FormField
extension TextInputFormField: FormField {
 var height: CGFloat { 44.0 }
 func register(for tableView: UITableView) {
 tableView.register(TextInputCell.self, forCellReuseIdentifier: "TextInputCell")
 }
 func dequeue(for tableView: UITableView, at indexPath: IndexPath) -> UITableViewCell {
 let cell = tableView.dequeueReusableCell(withIdentifier: "TextInputCell", for: indexPath) as! TextInputCell
 cell.delegate = self
 cell.configure(viewModel)
 return cell
 }
}

Form Demo

git clone git@github.com:nimblehq/ios-form.git
pod install

License

About