123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232 |
- // SelectorViewController.swift
- // Eureka ( https://github.com/xmartlabs/Eureka )
- //
- // Copyright (c) 2016 Xmartlabs SRL ( http://xmartlabs.com )
- //
- //
- // 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 Foundation
- import UIKit
- /**
- * Responsible for the options passed to a selector view controller
- */
- public protocol OptionsProviderRow: TypedRowType {
- associatedtype OptionsProviderType: OptionsProviderConformance
-
- var optionsProvider: OptionsProviderType? { get set }
-
- var cachedOptionsData: [OptionsProviderType.Option]? { get set }
- }
- extension OptionsProviderRow where Self: BaseRow {
-
- public var options: [OptionsProviderType.Option]? {
- set (newValue){
- let optProvider = OptionsProviderType.init(array: newValue)
- optionsProvider = optProvider
- }
- get {
- return self.cachedOptionsData ?? optionsProvider?.optionsArray
- }
- }
-
- public var cachedOptionsData: [OptionsProviderType.Option]? {
- get {
- return self._cachedOptionsData as? [OptionsProviderType.Option]
- }
- set {
- self._cachedOptionsData = newValue
- }
- }
- }
- public protocol OptionsProviderConformance: ExpressibleByArrayLiteral {
- associatedtype Option: Equatable
-
- init(array: [Option]?)
- func options(for selectorViewController: FormViewController, completion: @escaping ([Option]?) -> Void)
- var optionsArray: [Option]? { get }
-
- }
- /// Provider of selectable options.
- public enum OptionsProvider<T: Equatable>: OptionsProviderConformance {
-
- /// Synchronous provider that provides array of options it was initialized with
- case array([T]?)
- /// Provider that uses closure it was initialized with to provide options. Can be synchronous or asynchronous.
- case lazy((FormViewController, @escaping ([T]?) -> Void) -> Void)
-
- public init(array: [T]?) {
- self = .array(array)
- }
-
- public init(arrayLiteral elements: T...) {
- self = .array(elements)
- }
-
- public func options(for selectorViewController: FormViewController, completion: @escaping ([T]?) -> Void) {
- switch self {
- case let .array(array):
- completion(array)
- case let .lazy(fetch):
- fetch(selectorViewController, completion)
- }
- }
-
- public var optionsArray: [T]?{
- switch self {
- case let .array(arrayData):
- return arrayData
- default:
- return nil
- }
- }
- }
- open class _SelectorViewController<Row: SelectableRowType, OptionsRow: OptionsProviderRow>: FormViewController, TypedRowControllerType where Row: BaseRow, Row.Cell.Value == OptionsRow.OptionsProviderType.Option {
- /// The row that pushed or presented this controller
- public var row: RowOf<Row.Cell.Value>!
- public var enableDeselection = true
- public var dismissOnSelection = true
- public var dismissOnChange = true
- public var selectableRowSetup: ((_ row: Row) -> Void)?
- public var selectableRowCellUpdate: ((_ cell: Row.Cell, _ row: Row) -> Void)?
- public var selectableRowCellSetup: ((_ cell: Row.Cell, _ row: Row) -> Void)?
-
- /// A closure to be called when the controller disappears.
- public var onDismissCallback: ((UIViewController) -> Void)?
- /// A closure that should return key for particular row value.
- /// This key is later used to break options by sections.
- public var sectionKeyForValue: ((Row.Cell.Value) -> (String))?
- /// A closure that returns header title for a section for particular key.
- /// By default returns the key itself.
- public var sectionHeaderTitleForKey: ((String) -> String?)? = { $0 }
- /// A closure that returns footer title for a section for particular key.
- public var sectionFooterTitleForKey: ((String) -> String?)?
-
- public var optionsProviderRow: OptionsRow {
- return row as! OptionsRow
- }
- override public init(style: UITableView.Style) {
- super.init(style: style)
- }
- override public init(nibName nibNameOrNil: String?, bundle nibBundleOrNil: Bundle?) {
- super.init(nibName: nibNameOrNil, bundle: nibBundleOrNil)
- }
- convenience public init(_ callback: ((UIViewController) -> Void)?) {
- self.init(nibName: nil, bundle: nil)
- onDismissCallback = callback
- }
- public required init?(coder aDecoder: NSCoder) {
- super.init(coder: aDecoder)
- }
- open override func viewDidLoad() {
- super.viewDidLoad()
- setupForm()
- }
- open func setupForm() {
- let optProvider = optionsProviderRow.optionsProvider
- optProvider?.options(for: self) { [weak self] (options: [Row.Cell.Value]?) in
- guard let strongSelf = self, let options = options else { return }
- strongSelf.optionsProviderRow.cachedOptionsData = options
- strongSelf.setupForm(with: options)
- }
- }
-
- open func setupForm(with options: [Row.Cell.Value]) {
- if let optionsBySections = optionsBySections(with: options) {
- for (sectionKey, options) in optionsBySections {
- form +++ section(with: options,
- header: sectionHeaderTitleForKey?(sectionKey),
- footer: sectionFooterTitleForKey?(sectionKey))
- }
- } else {
- form +++ section(with: options, header: row.title, footer: nil)
- }
- }
-
- func optionsBySections(with options: [Row.Cell.Value]) -> [(String, [Row.Cell.Value])]? {
- guard let sectionKeyForValue = sectionKeyForValue else { return nil }
- let sections = options.reduce([:]) { (reduced, option) -> [String: [Row.Cell.Value]] in
- var reduced = reduced
- let key = sectionKeyForValue(option)
- reduced[key] = (reduced[key] ?? []) + [option]
- return reduced
- }
- return sections.sorted(by: { (lhs, rhs) in lhs.0 < rhs.0 })
- }
- func section(with options: [Row.Cell.Value], header: String?, footer: String?) -> SelectableSection<Row> {
- let section = SelectableSection<Row>(header: header, footer: footer, selectionType: .singleSelection(enableDeselection: enableDeselection)) { section in
- section.onSelectSelectableRow = { [weak self] _, row in
- let changed = self?.row.value != row.value
- self?.row.value = row.value
-
- if let form = row.section?.form {
- for section in form where section !== row.section {
- let section = section as Any as! SelectableSection<Row>
- if let selectedRow = section.selectedRow(), selectedRow !== row {
- selectedRow.value = nil
- selectedRow.updateCell()
- }
- }
- }
-
- if self?.dismissOnSelection == true || (changed && self?.dismissOnChange == true) {
- self?.onDismissCallback?(self!)
- }
- }
- }
- for option in options {
- section <<< Row.init(String(describing: option)) { lrow in
- lrow.title = self.row.displayValueFor?(option)
- lrow.selectableValue = option
- lrow.value = self.row.value == option ? option : nil
- self.selectableRowSetup?(lrow)
- }.cellSetup { [weak self] cell, row in
- self?.selectableRowCellSetup?(cell, row)
- }.cellUpdate { [weak self] cell, row in
- self?.selectableRowCellUpdate?(cell, row)
- }
- }
- return section
- }
- }
- /// Selector Controller (used to select one option among a list)
- open class SelectorViewController<OptionsRow: OptionsProviderRow>: _SelectorViewController<ListCheckRow<OptionsRow.OptionsProviderType.Option>, OptionsRow> {
- }
|