123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200 |
- //
- // QuickTableViewController.swift
- // QuickTableViewController
- //
- // Created by Ben on 25/08/2015.
- // Copyright (c) 2015 bcylin.
- //
- // Permission is hereby granted, free of charge, to any person obtaining a copy
- // of this software and associated documentation files (the "Software"), to deal
- // in the Software without restriction, including without limitation the rights
- // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- // copies of the Software, and to permit persons to whom the Software is
- // furnished to do so, subject to the following conditions:
- //
- // The above copyright notice and this permission notice shall be included in all
- // copies or substantial portions of the Software.
- //
- // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- // SOFTWARE.
- //
- import UIKit
- /// A table view controller that shows `tableContents` as formatted sections and rows.
- open class QuickTableViewController: UIViewController, UITableViewDataSource, UITableViewDelegate {
- /// A Boolean value indicating if the controller clears the selection when the collection view appears.
- open var clearsSelectionOnViewWillAppear = true
- /// Returns the table view managed by the controller object.
- open private(set) var tableView: UITableView = UITableView(frame: .zero, style: .grouped)
- /// The layout of sections and rows to display in the table view.
- open var tableContents: [Section] = [] {
- didSet {
- tableView.reloadData()
- }
- }
- // MARK: - Initialization
- /**
- Initializes a table view controller to manage a table view of a given style.
- - parameter style: A constant that specifies the style of table view that the controller object is to manage (`.plain` or `.grouped`).
- - returns: An initialized `QuickTableViewController` object.
- */
- public convenience init(style: UITableView.Style) {
- self.init(nibName: nil, bundle: nil)
- tableView = UITableView(frame: .zero, style: style)
- }
- deinit {
- tableView.dataSource = nil
- tableView.delegate = nil
- }
- // MARK: - UIViewController
- open override func viewDidLoad() {
- super.viewDidLoad()
- view.addSubview(tableView)
- tableView.frame = view.bounds
- tableView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
- tableView.rowHeight = UITableView.automaticDimension
- tableView.estimatedRowHeight = 44
- tableView.dataSource = self
- tableView.delegate = self
- }
- open override func viewWillAppear(_ animated: Bool) {
- super.viewWillAppear(animated)
- if let indexPath = tableView.indexPathForSelectedRow, clearsSelectionOnViewWillAppear {
- tableView.deselectRow(at: indexPath, animated: true)
- }
- }
- // MARK: - UITableViewDataSource
- open func numberOfSections(in tableView: UITableView) -> Int {
- return tableContents.count
- }
- open func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
- return tableContents[section].rows.count
- }
- open func tableView(_ tableView: UITableView, titleForHeaderInSection section: Int) -> String? {
- return tableContents[section].title
- }
- open func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
- let row = tableContents[indexPath.section].rows[indexPath.row]
- let cell =
- tableView.dequeueReusableCell(withIdentifier: row.cellReuseIdentifier) ??
- row.cellType.init(style: row.cellStyle, reuseIdentifier: row.cellReuseIdentifier)
- cell.defaultSetUp(with: row)
- (cell as? Configurable)?.configure(with: row)
- #if os(iOS)
- (cell as? SwitchCell)?.delegate = self
- #endif
- row.customize?(cell, row)
- return cell
- }
- open func tableView(_ tableView: UITableView, titleForFooterInSection section: Int) -> String? {
- return tableContents[section].footer
- }
- // MARK: - UITableViewDelegate
- open func tableView(_ tableView: UITableView, shouldHighlightRowAt indexPath: IndexPath) -> Bool {
- return tableContents[indexPath.section].rows[indexPath.row].isSelectable
- }
- open func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
- let section = tableContents[indexPath.section]
- let row = section.rows[indexPath.row]
- switch (section, row) {
- case let (radio as RadioSection, option as OptionRowCompatible):
- let changes: [IndexPath] = radio.toggle(option).map {
- IndexPath(row: $0, section: indexPath.section)
- }
- if changes.isEmpty {
- tableView.deselectRow(at: indexPath, animated: false)
- } else {
- tableView.reloadRows(at: changes, with: .automatic)
- }
- case let (_, option as OptionRowCompatible):
- // Allow OptionRow to be used without RadioSection.
- option.isSelected = !option.isSelected
- tableView.reloadData()
- #if os(tvOS)
- case let (_, row as SwitchRowCompatible):
- // SwitchRow on tvOS behaves like OptionRow.
- row.switchValue = !row.switchValue
- tableView.reloadData()
- #endif
- case (_, is TapActionRowCompatible):
- tableView.deselectRow(at: indexPath, animated: true)
- // Avoid some unwanted animation when the action also involves table view reload.
- DispatchQueue.main.async {
- row.action?(row)
- }
- case let (_, row) where row.isSelectable:
- DispatchQueue.main.async {
- row.action?(row)
- }
- default:
- break
- }
- }
- #if os(iOS)
- public func tableView(_ tableView: UITableView, accessoryButtonTappedForRowWith indexPath: IndexPath) {
- switch tableContents[indexPath.section].rows[indexPath.row] {
- case let row as NavigationRowCompatible:
- DispatchQueue.main.async {
- row.accessoryButtonAction?(row)
- }
- default:
- break
- }
- }
- #endif
- }
- #if os(iOS)
- extension QuickTableViewController: SwitchCellDelegate {
- // MARK: - SwitchCellDelegate
- open func switchCell(_ cell: SwitchCell, didToggleSwitch isOn: Bool) {
- guard
- let indexPath = tableView.indexPath(for: cell),
- let row = tableContents[indexPath.section].rows[indexPath.row] as? SwitchRowCompatible
- else {
- return
- }
- row.switchValue = isOn
- }
- }
- #endif
|