Typist:iOS上简洁的键盘监听库

前言

在iOS想要监听键盘的话是通过注册通知、接收键盘发来的通知实现的,虽然步骤不是很多,不过由于键盘的状态很多(有6种),如果需求要监听所有的状态,想想你要把相同的代码写6次,是有多烦人。而且适配的系统在iOS 9以下还要把一个个通知移除。这是有多不简洁...不过自从我遇到了Typist, 感觉优雅简洁到要死。

Typist简介

Typist is a small, drop-in Swift UIKit keyboard manager for iOS apps. It helps you manage keyboard's screen presence and behavior without notification center and Objective-C.

也就是说Typist主要方便了键盘显示的事件,那么他究竟是怎么方便的呢?下面这段代码就是Typist的简单使用:

 let keyboard = Typist.shared
keyboard
    .on(event: .didShow) { (options) in
        print("New Keyboard Frame is \(options.endFrame).")
    }
    .on(event: .didHide) { (options) in
        print("It took \(options.animationDuration) seconds to animate keyboard out.")
    }
    .start()

Oh, my god.怎么看上去和Rx有点像呀。哈哈,确实是的,不过这里作者只是运用了方法的链式调用。并没有Rx那么高大上哈。
如何你想要移除键盘监听,那么直接调用keyboard.clear()即可。
不过这里有点需要注意下,当有多个不同的对象都要监听键盘时,不要使用该单例。也就说这种情况下就需要你自己去创建Typist对象了,不要使用Typist.shared这个会导致你其中某些对象接受不到通知。

从键盘监听说起

在不使用Typist的情况下,我们是怎么做键盘监听的呢?


具体步骤如图所示。不过在如果你的应用支持iOS 9+以上,那么就可以不用去移除通知,这个在Apple文档里也有说明。
可能只是一张图你看不出来有多烦人,那么我用代码演示下是这样的。

而且这仅仅只是监听了键盘的实现方法,就已经需要这么多代码了。那么我们要是遇到需求要监听所有的键盘通知呢?那么上面代码就成了这样:

一堆样式相同的模板代码,有人会说,我需要一个函数封装下,不过还是还是不够Typist简洁。

那么Typiest是如何做键盘监听的

let keyboard = Typist.shared // #1
 
keyboard
    .on(event: .didShow) { (options) in // #2
        print("New Keyboard Frame is \(options.endFrame).")
    }
    .on(event: .didHide) { (options) in // #3
        print("It took \(options.animationDuration) seconds to animate keyboard out.")
    }
    .start() // #4

还是从简介中的这段代码说起,#1处是使用单例创建一个Typist对象;#2 处监听了键盘显示结束,闭包回调里的options包含了一些键盘信息,也就是NotificationCenter里面的info信息;#3 处监听了键盘的隐藏结束,闭包回调同上;#4 在这里开始监听,相当与我们使用的addobserver: 方法。
具体的逻辑如下图所示:


那么它内部究竟是怎么做的呢?

public func on(event: KeyboardEvent, do callback: TypistCallback?) -> Self 方法

这个方式的实现很简单,仅仅是将callbac回调放入一个dict里面,dict的key是event,然后返回自己。

public func on(event: KeyboardEvent, do callback: TypistCallback?) -> Self {
        callbacks[event] = callback
        return self
}

KeyboardEvent

作者在这里定义了一个枚举来封装了各个不同的键盘监听,然后我们在on方法里直接用传入枚举值就可以。

public enum KeyboardEvent {
    /// Event raised by UIKit's `.UIKeyboardWillShow`.
    case willShow
        
    /// Event raised by UIKit's `.UIKeyboardDidShow`.
    case didShow
        
    /// Event raised by UIKit's `.UIKeyboardWillShow`.
    case willHide
        
    /// Event raised by UIKit's `.UIKeyboardDidHide`.
    case didHide
        
    /// Event raised by UIKit's `.UIKeyboardWillChangeFrame`.
    case willChangeFrame
        
    /// Event raised by UIKit's `.UIKeyboardDidChangeFrame`.
    case didChangeFrame
}

start 方法

start在这里仅仅是注册了键盘通知,注意下addObserver方法的参数。这里的event就是上面的KeyboardEvent,通过event映射到NSNotification.Name 和 SEL。

/// Starts listening to events and calling corresponding events handlers.
    public func start() {
        let center = NotificationCenter.`default`
        
        for event in callbacks.keys {
            center.addObserver(self, selector: event.selector, name: event.notification, object: nil)
        }
    }

event.selector 与 event.notification 属性

这两个KeyboardEvent扩展下的私有属性分别返回上面提到的 NSNotification.Name 和 SEL

fileprivate extension Typist.KeyboardEvent {
    var notification: NSNotification.Name {
        get {
            switch self {
            case .willShow:
                return .UIKeyboardWillShow
            case .didShow:
                return .UIKeyboardDidShow
            case .willHide:
                return .UIKeyboardWillHide
            case .didHide:
                return .UIKeyboardDidHide
            case .willChangeFrame:
                return .UIKeyboardWillChangeFrame
            case .didChangeFrame:
                return .UIKeyboardDidChangeFrame
            }
        }
    }
    
    var selector: Selector {
        get {
            switch self {
            case .willShow:
                return #selector(Typist.keyboardWillShow(note:))
            case .didShow:
                return #selector(Typist.keyboardDidShow(note:))
            case .willHide:
                return #selector(Typist.keyboardWillHide(note:))
            case .didHide:
                return #selector(Typist.keyboardDidHide(note:))
            case .willChangeFrame:
                return #selector(Typist.keyboardWillChangeFrame(note:))
            case .didChangeFrame:
                return #selector(Typist.keyboardDidChangeFrame(note:))
            }
        }
    }
}

SEL 在哪里实现

关于上面的event.selector是如何实现调用的。实际上是通过闭包的形式调用,作者在这里实现了每一个的监听响应方法,然后在该方法里去调用闭包来做。具体闭包的实现是使用者来实现的,然后通过key为event的dict来获取闭包。
举例代码:

internal func keyboardWillShow(note: Notification) {
    if let callback = callbacks[.willShow] {
        callback(keyboardOptions(fromNotificationDictionary: note.userInfo))
    }
}

KeyboardOptions

这里主要是一些与键盘有关的信息。


总结

简单总结下该优雅的逻辑:

  1. let keyboard = Typist.shared
  2. 调用func on(event: KeyboardEvent, do callback: TypistCallback?),
    • 该方法中仅仅做了一件事:callbacks[event] = callback
    • 显然这个闭包是我们去实现的。
  3. 调用start()方法
    • 遍历了callbacks, 依次实现了addObserve方法,主要两个参数是selector: event.selector, name: event.notification
    • 其中event.notification event 和keyboard NSNotification.Name 的映射, event.selector中去调用了callbacks中的闭包,也就是我们的实现事件。
  4. 可以调用stop()方法移除通知。
    • 本质上是调用了removeObserver方法.

参考

Typist GitHub Repo
原文地址:https://vsccw.com/2017/02/26/for-typist/

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,185评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,445评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,684评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,564评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,681评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,874评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,025评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,761评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,217评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,545评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,694评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,351评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,988评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,778评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,007评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,427评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,580评论 2 349

推荐阅读更多精彩内容