[
](https://travis-ci.org/hackiftekhar/IQKeyboardManager)
It's been 11 years since it's first release in 2013. The library has grown a lot and we have added many new features since then.
Recently while working on bug fixes, I realized that in 2013 there were only 2 files IQKeyboardManager.{h,m} in Objective-C version, while now in Swift version there are 50+ files which makes the debugging a lot difficult than before. Also some of the features are rarely used in apps.
I realized that some of the features are not tightly linked to each other and can be moved out of the library easily. For Example:-
- IQTextView class
- IQKeyboardListener class
- IQTextFieldViewListener class
- IQReturnKeyHandler class
- Toolbar related features like IQToolbar and IQBarButtonItem and their support classes.
- ...
Moving above things out will make the library more lightweight and user can plug in/out features as per their needs.
I have decided to move loosly linked features out, and publish them to their separate github repo, and use them as dependencies as per requirements.
Below are the action plans
- [x] Publish IQKeyboardCore
- This contains necessary classes and functions to be used by IQKeyboardManager related libraries. Please note that you shouldn't directly install this as dependency
- [x] Publish IQTextView
- This is purely separated a separated library now.
- This usually used for showing placeholder in UITextView
- [x] Publish IQKeyboardReturnManager
- This is a renamed of IQReturnKeyHandler. This is also separated from the library and can be used independently.
- This depends on IQKeyboardCore for TextInputView type confirmation.
- [x] Publish IQTextInputViewNotification
- This is a renamed of IQTextFieldViewListener. This can be used independently to subscribe/unsubscribe for UITextView/UITextField beginEditing/endEditing events.
- This depends on the IQKeyboardCore to add some additional customized features for UITextView/UITextField.
- [x] Publish IQKeyboardToolbar
- This contains toolbar related classes like IQKeyboardToolbar, IQBarButtonItem, IQTitleBarButtonItems, their configuration classes and other useful functions to add toolbar in keyboard. This can be used independently to add toolbar in keyboard.
- This depends on the IQKeyboardCore to add some additional customized features for UITextView/UITextField.
- [x] Publish IQKeyboardToolbarManager
- This is something similar to IQKeyboardManager. This has been moved out of the library as a huge update.
- This depends on the IQTextInputViewNotification to know which textField is currently in focus.
- This depends on the IQKeyboardToolbar to add/remove toolbars over keyboard.
- [x] Publish IQKeyboardNotification
- This is a renamed of IQKeyboardListener. This can be used independently to subscribe/unsubscribe for keyboard events.
- [ ] Publish IQKeyboardManager 7.2.0 for all the current support without any compilation error but by deprecating most of the things which are moved out of the library.
- This now only contains functions for handling distance between UITextView/UITextField and their useful functions.
- This depends on the IQKeyboardNotification to get keyboard notification callbacks.
- This depends on the IQTextInputViewNotification to know which textField is currently in focus.
- Now there are also subspecs for now as of 7.2.0, but some of them will be removed in 8.0.0 because we already have separate library for this.
- IQKeyboardManagerSwift/Appearance
- IQKeyboardManagerSwift/IQKeyboardReturnKeyHandler
- IQKeyboardManagerSwift/IQKeyboardToolbarManager
- IQKeyboardManagerSwift/IQKeyboardToolbarManager/IQKeyboardToolbar
- IQKeyboardManagerSwift/IQTextView
- IQKeyboardManagerSwift/Resign
- [ ] Bug fixes which may have arrived due to the library segregation.
- We need your support on this one.
- [ ] Publish IQKeyboardManager 8.0.0 by marking deprecated classes as unavailable.
- In this release we will be removing all the deprecated classes and marking some of them as unavailable for easier migration.
While developing iOS apps, we often run into issues where the iPhone keyboard slides up and covers the UITextField/UITextView. IQKeyboardManager allows you to prevent this issue of keyboard sliding up and covering UITextField/UITextView without needing you to write any code or make any additional setup. To use IQKeyboardManager you simply need to add source files to your project.
1) One Lines of Code
2) Works Automatically
3) No More UIScrollView
4) No More Subclasses
5) No More Manual Work
6) No More #imports
IQKeyboardManager works on all orientations, and with the toolbar. It also has nice optional features allowing you to customize the distance from the text field, behaviour of previous, next and done buttons in the keyboard toolbar, play sound when the user navigates through the form and more.
@rebeloper demonstrated two videos on how to implement IQKeyboardManager at it's core:
https://www.youtube.com/playlist?list=PL_csAAO9PQ8aTL87XnueOXi3RpWE2m_8v
| Language | Minimum iOS Target | Minimum Xcode Version | |
|---|---|---|---|
| IQKeyboardManager | Obj-C | iOS 13.0 | Xcode 13 |
| IQKeyboardManagerSwift | Swift | iOS 13.0 | Xcode 13 |
| Demo Project | Xcode 15 |
| Swift | Xcode | IQKeyboardManagerSwift |
|---|---|---|
| 5.9, 5.8, 5.7, 5.6 | 15 | >= 7.0.0 |
| 5.5, 5.4, 5.3, 5.2, 5.1, 5.0, 4.2 | 11 | >= 6.5.7 |
| 5.1, 5.0, 4.2, 4.0, 3.2, 3.0 | 11 | >= 6.5.0 |
| 5.0,4.2, 4.0, 3.2, 3.0 | 10.2 | >= 6.2.1 |
| 4.2, 4.0, 3.2, 3.0 | 10.0 | >= 6.0.4 |
| 4.0, 3.2, 3.0 | 9.0 | 5.0.0 |
IQKeyboardManager (Objective-C): IQKeyboardManager is available through CocoaPods. To install
it, simply add the following line to your Podfile: (#9)
pod 'IQKeyboardManager' #iOS13 and later
IQKeyboardManager (Swift): IQKeyboardManagerSwift is available through CocoaPods. To install
it, simply add the following line to your Podfile: (#236)
Swift 5.9, 5.8, 5.7, 5.6, 5.5 (Xcode 15)
pod 'IQKeyboardManagerSwift'
Or you can choose the version you need based on Swift support table from Requirements
pod 'IQKeyboardManagerSwift', '6.3.0'
In AppDelegate.swift, just import IQKeyboardManagerSwift framework and enable IQKeyboardManager.
import IQKeyboardManagerSwift
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
var window: UIWindow?
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
IQKeyboardManager.shared.enable = true
return true
}
}
Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.
You can install Carthage with Homebrew using the following command:
$ brew update
$ brew install carthage
To integrate IQKeyboardManger or IQKeyboardManagerSwift into your Xcode project using Carthage, add the following line to your Cartfile:
github "hackiftekhar/IQKeyboardManager"
Run carthage to build the frameworks and drag the appropriate framework (IQKeyboardManager.framework or IQKeyboardManagerSwift.framework) into your Xcode project based on your need. Make sure to add only one framework and not both.
IQKeyboardManager (Objective-C): Just drag and drop IQKeyboardManager directory from demo project to your project. That's it.
IQKeyboardManager (Swift): Drag and drop IQKeyboardManagerSwift directory from demo project to your project
In AppDelegate.swift, just enable IQKeyboardManager.
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
var window: UIWindow?
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
IQKeyboardManager.shared.enable = true
return true
}
}
Swift Package Manager(SPM) is Apple's dependency manager tool. It is now supported in Xcode 11. So it can be used in all appleOS types of projects. It can be used alongside other tools like CocoaPods and Carthage as well.
To install IQKeyboardManagerSwift package via Xcode
If you would like to see detailed Flow diagram then check Detailed Flow Diagram.
Distributed under the MIT License.
Any contribution is more than welcome! You can contribute through pull requests and issues on GitHub.
If you wish to contact me, email at: hack.iftekhar@gmail.com
