美文网首页iOSiOS开发iOS Developer
iOS 键盘管理工具IQKeyboardManager

iOS 键盘管理工具IQKeyboardManager

作者: Lilin_Coder | 来源:发表于2016-08-17 17:15 被阅读10216次

    几乎所有应用中都会出现各种各样的输入框,比如登陆时候需要输入账号、密码,列表中常出现的搜索框,我们购物时候填写的收货地址等等,这些需求的共同点都是首先在输入框中输入信息,然后对信息进行验证提交,但是不要忘记了输入、提交过程中还有一个步骤:对键盘的操作。
    对键盘的调起、隐藏大概在我们学习iOS开发初期就会接触到,常用的方法有几种:
    1.对当前控制器的View添加一个tap手势,当点击的屏幕的时候判断页面中的输入控件是firstResponder时,就对它使用 resignFirstResponder。
    2.当键盘弹起时候点击键盘右下角的完成按钮。
    3.当界面有UITableView,滑动tableView时候进行隐藏。
    好啦 通过这几种方法我们可以完美的实现需求,在需要的时候调起键盘,输入完成时能通过点击、滑动等操作隐藏键盘。但是当添加一个新页面时,我们就需要把上边的逻辑重新写一遍,实在有够麻烦,好在我们有IQKeyboardManager, IQKeyboardManager是一个iOS keyboard 管理工具,它的一个功能是只需要两行代码就可以实现项目中所有页面的点击屏幕隐藏键盘操作,如果你愿意的话,导入包后不需要添加一行代码也可以实现,当然它的功能不仅仅这些,接下来我会介绍一下我们常用的一些功能。文章的最后我会写一下对IQKeyboardManager源码的分析,尽量做到知其然知其所以然。

    1.点击屏幕隐藏键盘

    IQKeyboardManager *keyboardManager = [IQKeyboardManager sharedManager];
    keyboardManager.shouldResignOnTouchOutside = YES;
    

    现在你已经可以在所有页面中点击屏幕隐藏键盘,等等,前边不是说可以一行代码都不需要添加吗,很简单,点开IQKeyboardManager.m文件,在+ ()load方法中添加 keyboardManager.shouldResignOnTouchOutside = YES;
    修改后的方法:

    +(void)load{    //Enabling IQKeyboardManager.
        [[IQKeyboardManagersharedManager] setEnable:YES];
        [IQKeyboardManagersharedManager].shouldResignOnTouchOutside = YES;
    }
    

    原理很简单,在你引用IQKeyboardManager头文件时,+()load方法会自动执行,原代码在这个方法里进行初始化工作,我们只需要添加上点击屏幕操作就可以了。

    2.键盘覆盖输入框时候页面自动上移

    这个功能现在你已经实现了。。。IQKeyboardManager同时支持手写代码和StoryBoard,当你的输入框被键盘覆盖后页面会自动上移。上移的距离由属性 keyboardDistanceFromTextField来控制。

    keyboardManager.keyboardDistanceFromTextField = 100;
    

    值得注意的是当你使用StoryBoard构建页面,如果将输入控件的top约束指向了Top Layout Guide时候该功能是无效的,StoryBoard中Top Layout Guide作为ViewController的一个属性,它表示了一个不希望被状态栏和导航栏覆盖的最高位置。当只存在Status Bar时候该位置在Status Bar的下边,当存在Navigation Bar时候该位置在Navigation Bar的下边。所以当控件的top约束指向它的时候控件位置是无法移动的。解决办法:top约束指向 Superview.Top 操作步骤:Editer -> pin -> View
    参考:
    http://stackoverflow.com/questions/28766210/autolayout-add-constraint-to-superview-and-not-top-layout-guide

    BA2E999B-2A91-46FA-9FBE-BC883FD197FD.png

    3.为键盘添加工具栏

    IQKeyboardManager 会自动为键盘添加一个工具栏,它包含一个左箭头一个右箭头切换输入框,还有一个done按钮来关闭键盘。
    可以通过属性 enableAutoToolbar 开启/关闭

    //关闭toolbar
    keyboardManager.enableAutoToolbar = NO;
    

    4.Navigation Bar显示

    If you wang to always show UINavigationBar, then change the UIView Class To UIScrollView.

    如果页面中带有 UINavigationBar,上移页面会将UINavigationBar一起移出屏幕外,框架作者提供了一个方法是UIScrollView替代控制器的View,但这样在少数情况下会出现控件错乱等副作用,所以使用这个方法时候要慎重

    源码分析

    1.监听通知

    在IQKeyboardManager 初始化时候通过监听 keyboard、UItextField、UITextViewField通知来完成对界面的控制

    2添加手势

    IQKeyboardManager在初始化时候创建了一个tap手势,当我们点击了textField时通过监听 UITextFieldTextDidBeginEditingNotification通知调用action
    -(void)textFieldViewDidBeginEditing:(NSNotification*)notification;在这方法里将tap手势添加到当前UITextField.window中,在tap手势的action方法中调用了完成对键盘的隐藏操作

    3.位移被覆盖的界面

    在监听到UIKeyboardWillShowNotification、UITextFieldTextDidBeginEditingNotification时候从UITextField.window.rootViewController中找到栈中最顶层的viewController,然后计算当前输入框和keyboard的距离,现在就可以通过修改viewController.view的top来完成对页面的上移,同样,当收到UIKeyboardWillHideNotification、UITextFieldTextDidEndEditingNotification通知时候将上移之后的view还原到原来的位置。

    写到最后:IQKeyboardManager作为一个维护了好几年的项目功能远不止这些,感兴趣的同学可以到github中下载,里边的Demo展示了所有功能。这个项目逻辑清晰,功能强大,对于学习和使用都为我带来了很大的帮助,感谢作者为我们带来了如此优秀的开源项目。

    相关文章

      网友评论

      • 你好牛:为什么我的没有左右箭头
        冰land:我也遇到这种问题了
      • 风___________:楼主,你知道IQKeyboardManager 自带done按钮是如何实现的么,为啥源码doneAction断点无效
      • 橘子的皮:你好,我用pod集成的,xcode8.2,在appdelegate一添加代码就闪退了
        橘子的皮:2017-04-13 14:03:50.456 testProduct[17730:382487] -[UITextField addDoneOnKeyboardWithTarget:action:]: unrecognized selector sent to instance 0x7f9ad8c036b0
      • 鬼丶白:你好请问 在scrollView 上的textField第一次点击View不上升怎么解决啊
        雪_晟:你好,我也遇到这个问题了,您解决了吗
      • 番茄大叔:请问 我的输入框 放在了self.view.window上面,类似弹窗的作用,但是这个并不好用,有什么解决办法么
      • Felix灬泡泡:使用IQKeyboardManager,在UITableViewController点击空白区域,键盘不退出,怎么解决?(XCode 8.1) :sob:
      • ddf82c5e7477:你好,请问你知道怎么在滑动 tableView 的时候隐藏键盘吗?
        对月成三人:@Lilin_Coder 设置tableview的keyboardDismissMode属性为UIScrollViewKeyboardDismissModeOnDrag
        Lilin_Coder:@巴黎有条狗 IQKeyboardManage无法实现,可以通过tableview的代理方法 scrollViewDidScroll完成

      本文标题:iOS 键盘管理工具IQKeyboardManager

      本文链接:https://www.haomeiwen.com/subject/prbmsttx.html