在日常開發(fā)之余蹬屹，用 Swift 寫了一個(gè)快速處理事件傳遞&處理的庫 FastActions，簡(jiǎn)化事件的傳遞流程包个，提高編碼效率垛玻。
FastActions 是一個(gè)用純 Swift 來實(shí)現(xiàn)的快捷的事件處理庫。在 MVC 架構(gòu)模式開發(fā)泽谨，事件傳遞一件麻煩的事情璧榄，同層的 View 與 ViewController 通訊，通常使用 Delegate 來傳遞與處理事件吧雹，跨層訪問則會(huì)用 Notification骨杂。這兩種方式都比較繁瑣，F(xiàn)astActions 的目的是取代 Delegate 與 Notification 來傳遞與處理事件雄卷。
Features
- [x] View 向所在的 ViewController 或其 ChildViewControllers 搓蚪、ParentViewController 發(fā)送事件
- [x] View 向所在的 NavigationController 的 viewControllers 發(fā)送事件，支持透?jìng)骰騿我豁憫?yīng)
- [x] View 可以任意對(duì)象發(fā)送事件丁鹉，可以取代 Notification
- [x] 支持 Button 快捷發(fā)送事件
- [x] View 支持 GestureRecognizer 事件發(fā)送
- [x] 支持 Swift 5.0+
最簡(jiǎn)單的用例是 Button 點(diǎn)擊時(shí)向所在的 ViewController 發(fā)送事件妒潭，只需要調(diào)用 button 的擴(kuò)展方法發(fā)送事件，在 ViewController 實(shí)現(xiàn) FastActionsMaps 協(xié)議的 fastActionsMaps 的方法鳄炉，則可以獲取到事件:
// View.swift
let params = FastActionsParams(tag: "kBntClickAction")
params.data = "Hi FastActions"
self.button.fa.addDispatchToVC(params: params, forControlEvents: .touchUpInside)
// or
// self.button.fa.addDispatchToVC("kBntClickAction", forControlEvents: .touchUpInside)
// ViewController.swift
extension ViewController: FastActionsMaps {
func fastActionsMaps() -> Dictionary<String, Selector> {
return [
"kBntClickAction":#selector(clickBtn(_:)),
]
}
@objc func clickBtn(_ params: FastActionsParams) {
print(params.data ?? "data is nil")
}
}
使用 FastActions 向全局傳遞事件杜耙，響應(yīng)者需要選擇 subscribe 才能正常響應(yīng)全局事件傳遞，在 deinit 時(shí)也需要 unsubscribe拂盯，F(xiàn)astActions 全局事件傳遞的內(nèi)部是基于觀察者模式實(shí)現(xiàn)的：
// View.swift
let params = FastActionsParams(tag: "kDispatchAllAction")
params.data = "Hi FastAction"
sender.fa.dispatch(params: params)
// ViewController.swift
class ViewController: UIViewController {
deinit {
self.fa.unsubscribe()
}
override func viewDidLoad() {
super.viewDidLoad()
self.fa.subscribe()
}
}
extension NextViewController: FastActionsMaps {
func fastActionsMaps() -> Dictionary<String, Selector> {
return [
"kDispatchAllAction":#selector(clickBtn(_:)),
]
}
@objc func clickBtn(_ params: FastActionsParams) {
print(params.data ?? "data is nil")
}
}
Requirements
- iOS 9.0+ / macOS 10.12+ / tvOS 10.0+
- Swift 4.2+
Installation
CocoaPods
使用 CocoaPods 將 FastActions 集成到 Xcode 項(xiàng)目中佑女，需要將 Podfile 中指定的 target 添加:
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'
use_frameworks!
target 'MyApp' do
# other pod
pod 'FastActions'
end
然后執(zhí)行以下命令：
$ pod install
Carthage
使用 Carthage 將 FastActions 集成到 Xcode 項(xiàng)目中，需要在 Cartfile 中指定它:
github "dengyhgit/FastActions" ~> 1.0
然后，運(yùn)行以下命令構(gòu)建 FastActions framework:
$ carthage update FastActions --platform iOS
# Or `--platform macOS`, `--platform tvOS`
Other
Future of FastActions
FastActions 其目的主要是為事件傳遞提供更便捷的方式团驱， 以提高我們的開發(fā)效率摸吠。FastActions 目前只提供了一些基本功能，它還有很大的改進(jìn)空間嚎花，我們?cè)诤竺鏁?huì)提供更多功能寸痢，讓其變得更完善。當(dāng)然紊选，希望大家可以共同參與進(jìn)來啼止，共同努力。如果你在使用的時(shí)候遇到問題兵罢，也可以給我們提 Issues献烦。
License
FastActions 是基于 MIT 協(xié)議下發(fā)布的，其詳細(xì)信息卖词，請(qǐng)參 LICENSE 文件巩那。
