键盘处理神奇一 IQKeyboardManager

最新推荐文章于 2025-06-02 09:04:53 发布

转载最新推荐文章于 2025-06-02 09:04:53 发布 · 2k 阅读

ios开发专栏收录该内容

148 篇文章

订阅专栏

IQKeyboardManager是一款用于自动处理iOS应用中键盘事件的第三方库。它能够有效解决键盘遮挡输入框的问题，提升用户体验。该库支持键盘上的工具条自定义、屏幕旋转等功能，并且易于集成。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

每一个iOS应用的开发者在工作中都会遇到需要用户键盘输入数据的需求，而输入框(UITextField/UITextView)的父界面可能是普通的UIView，也可能是UIScrollView，UITableView，UICollectionView 等。而如果输入框位于屏幕的底部，弹起的键盘很可能覆盖输入框，导致用户就看不到输入结果，体验较差。

IQKeyboardManager 为此应运而生，使用IQKeyboardManager可以很容易地解决弹起键盘遮盖输入框的问题，并且易于集成，不需要侵入性地继承特定的类，也不需要实现某些奇怪的协议，满足大部分需求只需要少于5行代码。更让人惊喜的是IQKeyboardManager已经提供Swift版本。

IQKeyboardManager 官方例子下载地址

官方效果图

首先下载第三方库源码导入已有项目中(也可以使用CocoaPods), 然后只需要一行代码就可控制自动键盘处理事件在整个项目内是否启用。

// iOS delegate内应用入口

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

//关闭设置为NO, 默认值为NO.

[IQKeyboardManager sharedManager].enable = YES;

}

如果产品需要当键盘弹起时，点击背景收起键盘，也是一行代码解决。

[IQKeyboardManager sharedManager].shouldResignOnTouchOutside = YES;

而当产品需要支持内联编辑(Inline Editing), 这就需要隐藏键盘上的工具条(默认打开)

[IQKeyboardManager sharedManager].enableAutoToolbar = NO;

如果当某一个输入框特定不需要键盘上的工具条时，一行代码

textField.inputAccessoryView = [[UIView alloc] init];

如果因为不知名的原因需要在某个页面禁止自动键盘处理事件相应，也很简单。

- (void) viewWillAppear: (BOOL)animated {

//打开键盘事件相应

[IQKeyboardManager sharedManager].enable = NO;

}

- (void) viewWillDisappear: (BOOL)animated {

//关闭键盘事件相应

[IQKeyboardManager sharedManager].enable = YES;

}

另外IQKeyboardManager支持屏幕旋转功能，这对一些应用特别有用。

请注意的是，IQKeyboardManager还有一些未解决的问题列表(点击这里)，如果使用过程发现问题，可以对照参考，免得浪费不必要的时间。

思考题：如何替换IQKeyboardManager内默认提供键盘上的工具条视图？

以下是 IQKeyboardManager 的一些具体使用

1. 用 Cocoapod 导入或直接下载拖进去，这里方便起见直接用 Cocoapod 导入。

IQKeyboardManager 的 GitHub地址：IQKeyboardManager 的 GitHub 地址

2. 在 AppDelegate.m 中导入头文件

#import <IQKeyboardManager/IQKeyboardManager.h>

3. 在 AppDelegate 中设置全局属性

 - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    IQKeyboardManager *keyboardManager = [IQKeyboardManager sharedManager]; // 获取类库的单例变量

    keyboardManager.enable = YES; // 控制整个功能是否启用

    keyboardManager.shouldResignOnTouchOutside = YES; // 控制点击背景是否收起键盘

    keyboardManager.shouldToolbarUsesTextFieldTintColor = YES; // 控制键盘上的工具条文字颜色是否用户自定义

    keyboardManager.toolbarManageBehaviour = IQAutoToolbarBySubviews; // 有多个输入框时，可以通过点击Toolbar 上的“前一个”“后一个”按钮来实现移动到不同的输入框

    keyboardManager.enableAutoToolbar = YES; // 控制是否显示键盘上的工具条

    keyboardManager.shouldShowTextFieldPlaceholder = YES; // 是否显示占位文字

    keyboardManager.placeholderFont = [UIFont boldSystemFontOfSize:17]; // 设置占位文字的字体

    keyboardManager.keyboardDistanceFromTextField = 10.0f; // 输入框距离键盘的距离

    return YES;
}

4. 若某个类不需要使用 IQKeyboardManager，可以在这个类中这样设置

  - (void)viewWillAppear:(BOOL)animated {
  [super viewWillAppear:animated];
   [IQKeyboardManager sharedManager].enable = NO;
}

  - (void)viewWillDisappear:(BOOL)animated {
  [super viewWillDisappear:animated]; 
  [IQKeyboardManager sharedManager].enable = YES;
}