Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/AckeeCZ/ACKReactiveExtensions
Set of useful extensions for ReactiveSwift & ReactiveCocoa
https://github.com/AckeeCZ/ACKReactiveExtensions
ios reactivecocoa reactiveswift swift
Last synced: 3 months ago
JSON representation
Set of useful extensions for ReactiveSwift & ReactiveCocoa
- Host: GitHub
- URL: https://github.com/AckeeCZ/ACKReactiveExtensions
- Owner: AckeeCZ
- License: mit
- Created: 2017-03-08T10:04:40.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2024-03-26T16:45:15.000Z (7 months ago)
- Last Synced: 2024-04-23T19:19:13.769Z (6 months ago)
- Topics: ios, reactivecocoa, reactiveswift, swift
- Language: Swift
- Homepage:
- Size: 25.2 MB
- Stars: 17
- Watchers: 8
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios-star - ACKReactiveExtensions - Useful extensions for ReactiveCocoa (Reactive Programming / Prototyping)
- awesome-ios - ACKReactiveExtensions - Useful extensions for ReactiveCocoa (Reactive Programming / Prototyping)
README
# ACKReactiveExtensions
ACKReactiveExtensions is set of useful extensions for ReactiveCocoa you could use in your apps.
Currently we have extensions for
- UIKit
- WebKit
If you'd love to have more extensions available just open an issue or even better create a pull request!
## Installation
You can use Carthage by adding it to your Cartfile:
```
github "AckeeCZ/ACKReactiveExtensions
```
Or you can use SPM by adding it to you _Package.swift_.
## Usage
Usage is really simple, ACKReactiveExtensions contains just more extensions for ReactiveSwift's `Reactive` struct so it can be used on more objects.
#### Mapping configuration
In general we are against mapping objects on main thread (and you should be too), but you know, you only live once so we still give you the opportunity to do so. By default our mapping extensions allow this behavior but if you want to restrict that, you can do that by setting a configuration variable.
```swift
ACKReactiveExtensionsConfiguration.allowMappingOnMainThread = false
```
From now on the mapping extensions will expect to be called on background thread, but don't worry, we use asserts so your production users are safe from crashing if somehow things don't go as good as expected.
### UITextField/UITextView two way binding
ACKReactiveExtensions contains special `<~>` two way binding operator which will create binding between `MutableProperty` and your `UITextField`/`UITextView`.
Until now all those bindings looked like this
```swift
let textProperty: MutableProperty ...
let textField: UITextField ...
textField.reactive.text <~ textProperty
textProperty <~ textField.reactive.continousTextValues
```
From now on you can use the `<~>` operator
```swift
textProperty <~> textField
```
The `<~>` operator is commutative so the order of operands doesn't matter.
## Author
[Ackee](https://ackee.cz) team
## License
ACKategories is available under the MIT license. See the LICENSE file for more info.
[1]: https://twitter.com/AckeeCZ