Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lm2343635/rxpanmodal
RxSwift reactive extension for PanModal.
https://github.com/lm2343635/rxpanmodal
Last synced: about 1 month ago
JSON representation
RxSwift reactive extension for PanModal.
- Host: GitHub
- URL: https://github.com/lm2343635/rxpanmodal
- Owner: lm2343635
- License: mit
- Created: 2020-03-05T12:54:05.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-03-05T15:29:53.000Z (over 4 years ago)
- Last Synced: 2024-10-07T13:01:18.081Z (about 1 month ago)
- Language: Swift
- Homepage:
- Size: 203 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# RxPanModal
[](https://app.bitrise.io/app/b831d3c7c2819e78)
[](https://cocoapods.org/pods/RxPanModal)
[](https://cocoapods.org/pods/RxPanModal)
[](https://cocoapods.org/pods/RxPanModal)
RxPanModal is a RxSwift reactive extension for the library PanModal. With RxPanModal, a view controller can be presented as a pan modal from the view model directly.
## Documentation
RxPanModal is available through [CocoaPods](https://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'RxPanModal'
```
### Present customized view controller as a pan modal
To present a view controller as a pan modal from a view model directly, the view controller should implement the procotol `RxPanModalPresentable`.
```swift
extension SelectorViewController: RxPanModalPresentable {
static func create(item: RxPanModalItem) -> Self? {
guard let item = item as? SelectorPanModalItem else {
return nil
}
return self.init(item: item)
}
var panScrollable: UIScrollView? {
return tableView
}
}
```
In the static method `create`, there is a struct `SelectorPanModalItem` which implements the protocol `RxPanModalItem`.
```swift
struct SelectorPanModalItem: RxPanModalItem {
static let controllerType: RxPanModalPresentable.Type = SelectorViewController.self
let names: [String]
let didNameSelected: (String) -> Void
}
```
In the item struct, the controller type should be indicated.
Other properties and closures for exchanging data with view model should also be defined in the item struct.
After implementing the customized view modal, a `PublishSubject` property `panModal` should be prepared in the view model.
```swift
class ViewModel {
private let panModalSubject = PublishSubject()
var panModal: Observable {
return panModalSubject.asObservable()
}
}
```
The corresponding view controller should implement the protocol `RxPanModalShowable` and bind the observable `panModel`.
```swift
class ViewController: UIViewController, RxPanModalShowable {
override func viewDidLoad() {
super.viewDidLoad()
viewModel.name.bind(to: nameLabel.rx.text).disposed(by: disposeBag)
}
}
```
At last, we can present the customized view controller from the view model directly.
```swift
panModalSubject.onNext(item: SelectorPanModalItem(names: ["Alice", "Bob", "Carol"]) {
print($0)
})
```
### Prepared template
To use the prepared template view controllers, just install with the subspec `RxPanModal/Template`.
```ruby
pod 'RxPanModal/Template'
```
The following templates in prepared.
- RxPanModalPickerViewController
```swift
panModalSubject.onNextPicker(
theme: .dark,
title: "Months",
done: "Done",
models: ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Nov", "Dec"],
didSelectItemAt: { index, model in
print("select at \(index) " + model.description)
},
doneAt: { index, model in
print("done at \(index) " + model.description)
}
)
```
### Dissmiss all presented pan modals.
Sometimes, if you want to dismiss all presented pan modals, just invoke `RxPanModal.dismissAll()` from anywhere.
## Example
To run the example project, clone the repo, and run `pod install` from the Example directory first.
## License
RxPanModal is available under the MIT license. See the LICENSE file for more info.