专注、坚持

Swift 中的 Selector

2017.01.31 by kingcos

Preface

Focus,即专注。笔者希望可以尽力将一些不是那么透彻的点透过 Demo 和 Source Code 而看到其本质。

由于国内软件开发仍很大程度依赖国外的语言、知识,所以该博客中的术语将使用英文表述,除非一些特别统一的词汇或整段翻译时将使用中文,但也会在首次提及时标注英文。笔者英文水平有限,这样的目的也是尽可能减少歧义,但在其中不免有所错误,遗漏,还请大家多多批评、指正。

What

常用纯代码来开发的同学都应该比较熟悉这个方法:

func addTarget(_ target: Any?, action: Selector, for controlEvents: UIControlEvents)

Selector 源自 Objective-C,例如 SEL 类型,以及 @selector() 方法选择器。Swift 中也兼容了这个概念,不过随着 Swift 的迭代,Selector 的一些写法也出现了很大的变化。比较遗憾的是,官方文档对于 Selector 没有介绍:

Selector in Xcode Documentation & API Reference

因此只能自己总结一下 Swift 3.0 中的 Selector,便有利于自己理解,也便于以后的参考。注:以下 Demo 中的 cyanButton 是用 StoryBoard 拖拽的。

Selector 类型

Swift 中的 Selector 类型其实就是 Objective-C 中的 SEL 类型。在 Swift 中,Selector 的本质是结构体。常用的构造 Selector 类型变量的方法有以下几种:

  • public init(_ str: String)

类似 Objective-C 中的 NSSelectorFromString,Swift 中的 Selector 也可以使用字符串来构造:

@IBOutlet weak var cyanButton: UIButton!

override func viewDidLoad() {
    super.viewDidLoad()

    cyanButton.addTarget(self,
                         action: Selector("cyanButtonClick"),
                         for: .touchUpInside)
}

func cyanButtonClick() {
    print(#function)
}
  • #selector()

通过字符串构造 Selector 变量是一种方法,但是当在上例中 Xcode 会提示这样的警告:Use '#selector' instead of explicitly constructing a 'Selector'。即使用 #selector() 代替字符串明确构造 Selector 将更加安全。

@IBOutlet weak var cyanButton: UIButton!

override func viewDidLoad() {
    super.viewDidLoad()

    cyanButton.addTarget(self,
                         action: #selector(ViewController.cyanButtonClick),
                         for: .touchUpInside)
}

func cyanButtonClick() {
    print(#function)
}

#selector() 的好处是不再需要使用字符串来构造。因为当使用字符串构造时,若传入的字符串没有对应的方法名,那么程序在执行时就会直接崩溃:unrecognized selector sent to instance

若当前作用域构造 Selector 的方法名唯一时,可以直接使用方法名,而省略作用域。

cyanButton.addTarget(self,
                     action: #selector(cyanButtonClick),
                     for: .touchUpInside)

若是 Swift 中的私有方法,则必须赋予其 Objective-C 的 runtime(运行时)。即在方法名前加上 @objc

@IBOutlet weak var cyanButton: UIButton!
@IBOutlet weak var anotherCyanButton: UIButton!

override func viewDidLoad() {
    super.viewDidLoad()
    cyanButton.addTarget(self,
                         action: #selector(ViewController.cyanButtonClick(_:)),
                         for: .touchUpInside)

    // 当前作用域 cyanButtonClick 存在冲突,不能直接使用方法名
    //「Ambiguous use of 'cyanButtonClick'」
    // anotherCyanButton.addTarget(self,
                                action: #selector(cyanButtonClick),
                                for: .touchUpInside)
}

// 无参方法
func cyanButtonClick() {
    print(#function)
}

// 有参私有方法
@objc private func cyanButtonClick(_ button: UIButton) {
    let btnLabel = button.titleLabel?.text ?? "nil"
    print(btnLabel)
    print(#function)
}

当遇到上述存在歧义的相同方法名时,也可以使用强制类型转换来解决:

@IBOutlet weak var cyanButton: UIButton!
@IBOutlet weak var anotherCyanButton: UIButton!

override func viewDidLoad() {
    super.viewDidLoad()

    let methodA = #selector(cyanButtonClick as () -> ())
    let methodB = #selector(cyanButtonClick as (UIButton) -> ())

    cyanButton.addTarget(self,
                         action: methodA,
                         for: .touchUpInside)
    anotherCyanButton.addTarget(self,
                                action: methodB,
                                for: .touchUpInside)
}

func cyanButtonClick() {
    print(#function)
}

@objc private func cyanButtonClick(_ button: UIButton) {
    let btnLabel = button.titleLabel?.text ?? "nil"
    print(btnLabel)
    print(#function)
}
  • #selector() & Seletcor("")

通过上面的 Demo,也可以看出 #selector() 更加安全、清晰,但是 Seletcor("") 并不是一无是处。当我们需要调用标准库中的私有方法时,只能通过字符串来构造。

为了方便测试,此处自定义了一个 CustomViewController。其中带有私有方法:@objc private func privateFunc() 以及 func defaultFunc()。此处使用的 ViewController 继承自 CustomViewController

// CustomViewController.swift

class CustomViewController: UIViewController {

    @objc private func privateFunc() {
        print(#function)
    }

    func defaultFunc() {
        print(#function)
    }

}

// ViewController.swift

class ViewController: CustomViewController {

    @IBOutlet weak var cyanButton: UIButton!
    @IBOutlet weak var anotherCyanButton: UIButton!

    override func viewDidLoad() {
        super.viewDidLoad()

        cyanButton.addTarget(self,
                             action: #selector(defaultFunc),
                             for: .touchUpInside)
        anotherCyanButton.addTarget(self,
                                    action: Selector("privateFunc"),
                                    for: .touchUpInside)
    }

}

因为父类的私有方法对子类来说是不可见的,直接使用 #selector() 无法通过编译,但这个方法确实存在,所以这里只能使用字符串来构造 Selector。

当然这里 Xcode 会提示警告,但仍然可以编译通过并运行,所以这并不是官方提倡的行为。这是我在将系统边缘返回改写全屏返回时,发现私有的 handleNavigationTransition: 方法不能通过 #selector(),因此使用了字符串代替。

Syntax Sugar

配合 Swift 的 Extension,可以使用其管理当前控制器的所有 Selector:

import UIKit

fileprivate extension Selector {
    static let redButtonClick = #selector(ViewController.redButtonClick(_:))
    static let cyanButtonClick = #selector(ViewController.cyanButtonClick)
}

class ViewController: CustomViewController {

    @IBOutlet weak var cyanButton: UIButton!
    @IBOutlet weak var redButton: UIButton!

    override func viewDidLoad() {
        super.viewDidLoad()

        cyanButton.addTarget(self,
                             action: .cyanButtonClick,
                             for: .touchUpInside)
        redButton.addTarget(self,
                            action: .redButtonClick,
                            for: .touchUpInside)
    }

    func cyanButtonClick() {
        print(#function)
    }

    func redButtonClick(_ button: UIButton) {
        let btnLabel = button.titleLabel?.text ?? "nil"
        print(btnLabel)
        print(#function)
    }

}

getter & setter

Swift 3.0 中加入了 Selector 引用变量(不可为常量)的 getter 和 setter 方法:

class Person: NSObject {
    dynamic var firstName: String
    dynamic let lastName: String
    dynamic var fullName: String {
        return "\(firstName) \(lastName)"
    }

    init(firstName: String, lastName: String) {
        self.firstName = firstName
        self.lastName = lastName
    }
}

fileprivate extension Selector {
    static let firstNameGetter = #selector(getter: Person.firstName)
    static let firstNameSetter = #selector(setter: Person.firstName)
}

Reference