FastActions.png

在日常开发之余，用 Swift 写了一个快速处理事件传递&处理的库 FastActions，简化事件的传递流程，提高编码效率。

FastActions 是一个用纯 Swift 来实现的快捷的事件处理库。在 MVC 架构模式开发，事件传递一件麻烦的事情，同层的 View 与 ViewController 通讯，通常使用 Delegate 来传递与处理事件，跨层访问则会用 Notification。这两种方式都比较繁琐，FastActions 的目的是取代 Delegate 与 Notification 来传递与处理事件。

Features

[x] View 向所在的 ViewController 或其 ChildViewControllers 、ParentViewController 发送事件
[x] View 向所在的 NavigationController 的 viewControllers 发送事件，支持透传或单一响应
[x] View 可以任意对象发送事件，可以取代 Notification
[x] 支持 Button 快捷发送事件
[x] View 支持 GestureRecognizer 事件发送
[x] 支持 Swift 5.0+

最简单的用例是 Button 点击时向所在的 ViewController 发送事件，只需要调用 button 的扩展方法发送事件，在 ViewController 实现 FastActionsMaps 协议的 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 向全局传递事件，响应者需要选择 subscribe 才能正常响应全局事件传递，在 deinit 时也需要 unsubscribe，FastActions 全局事件传递的内部是基于观察者模式实现的：

// 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 项目中，需要将 Podfile 中指定的 target 添加:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'
use_frameworks!

target 'MyApp' do
  # other pod
  pod 'FastActions'
end

然后执行以下命令：

$ pod install

Carthage

使用 Carthage 将 FastActions 集成到 Xcode 项目中，需要在 Cartfile 中指定它:

github "dengyhgit/FastActions" ~> 1.0

然后，运行以下命令构建 FastActions framework:

$ carthage update FastActions --platform iOS
# Or `--platform macOS`, `--platform tvOS`

Other

Future of FastActions

FastActions 其目的主要是为事件传递提供更便捷的方式，以提高我们的开发效率。FastActions 目前只提供了一些基本功能，它还有很大的改进空间，我们在后面会提供更多功能，让其变得更完善。当然，希望大家可以共同参与进来，共同努力。如果你在使用的时候遇到问题，也可以给我们提 Issues。

License

FastActions 是基于 MIT 协议下发布的，其详细信息，请参 LICENSE 文件。

开源 FastAction 事件处理库