Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/onmyway133/easyclosure
🍩 Unified communication patterns with easy closure in Swift
https://github.com/onmyway133/easyclosure
action closure on swift target
Last synced: 2 days ago
JSON representation
🍩 Unified communication patterns with easy closure in Swift
- Host: GitHub
- URL: https://github.com/onmyway133/easyclosure
- Owner: onmyway133
- License: other
- Created: 2019-05-18T19:43:49.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-06-11T06:24:26.000Z (over 4 years ago)
- Last Synced: 2024-09-20T15:25:58.877Z (6 days ago)
- Topics: action, closure, on, swift, target
- Language: Swift
- Homepage: https://onmyway133.github.io/
- Size: 1.15 MB
- Stars: 201
- Watchers: 7
- Forks: 12
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# EasyClosure
❤️ Support my apps ❤️
- [Push Hero - pure Swift native macOS application to test push notifications](https://onmyway133.com/pushhero)
- [PastePal - Pasteboard, note and shortcut manager](https://onmyway133.com/pastepal)
- [Quick Check - smart todo manager](https://onmyway133.com/quickcheck)
- [Alias - App and file shortcut manager](https://onmyway133.com/alias)
- [My other apps](https://onmyway133.com/apps/)
❤️❤️😇😍🤘❤️❤️
[](http://cocoadocs.org/docsets/EasyClosure)
[](https://github.com/Carthage/Carthage)
[](http://cocoadocs.org/docsets/EasyClosure)
[](http://cocoadocs.org/docsets/EasyClosure)
## Table of contents
- [Story](#story)
- [Target-Action and Delegate](#target-action-and-delegate)
- [Extensible](#extensible)
## Story
There are many [Communication patterns](https://www.objc.io/issues/7-foundation/communication-patterns/)
Sometimes, you just want a unified and quick way to do it. Just call `on` on any `NSObject` subclasses and handle your events the quickest way
### Features
- [x] Shortcut to handle actions and events
- [x] Easy to extend
- [x] Correct method suggestion based on generic protocol constraint
- [x] Support iOS, macOS
### Example
We can make a fun demo of `good, cheap, fast` with `UISwitch`
```swift
func allOn() -> Bool {
return [good, cheap, fast].filter({ $0.isOn }).count == 3
}
good.on.valueChange { _ in
if allOn() {
fast.setOn(false, animated: true)
}
}
cheap.on.valueChange { _ in
if allOn() {
good.setOn(false, animated: true)
}
}
fast.on.valueChange { _ in
if allOn() {
cheap.setOn(false, animated: true)
}
}
```
## Target-Action and Delegate
#### UIButton
```swift
button.on.tap {
print("button has been tapped")
}
```
#### UISlider
```swift
slider.on.valueChange { value in
print("slider has changed value")
}
```
#### UITextField
```swift
textField.on.textChange { text in
print("textField text has changed")
}
```
#### UITextView
```swift
textView.on.textChange { text in
print("textView text has changed")
}
```
#### UISearchBar
```swift
searchBar.on.textChange { text in
print("searchBar text has changed")
}
```
#### UIDatePicker
```swift
datePicker.on.pick { date in
print("datePicker has changed date")
}
```
#### UIBarButtonItem
```swift
barButtonItem.on.tap {
print("barButtonItem has been tapped")
}
```
#### UIGestureRecognizer
```swift
gestureRecognizer.on.occur {
print("gesture just occured")
}
```
## Extensible
Extend `Container` and specify `Host` to add more functionalities to your own types. For example
```swift
public extension Container where Host: UITableView {
func cellTap(_ action: @escaping (UITableViewCell) -> Void)) {
// Your code here here
}
}
// usage
let tableView = UITableView()
tableView.on.cellTap { cell in
}
```
## Installation
**EasyClosure** is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'EasyClosure'
```
**EasyClosure** is also available through [Carthage](https://github.com/Carthage/Carthage).
To install just write into your Cartfile:
```ruby
github "onmyway133/EasyClosure"
```
**EasyClosure** can also be installed manually. Just download and drop `Sources` folders in your project.
## Author
Khoa Pham, [email protected]
## Contributing
We would love you to contribute to **EasyClosure**, check the [CONTRIBUTING](https://github.com/onmyway133/EasyClosure/blob/master/CONTRIBUTING.md) file for more info.
## License
**EasyClosure** is available under the MIT license. See the [LICENSE](https://github.com/onmyway133/EasyClosure/blob/master/LICENSE.md) file for more info.