Codeless drop-in universal library allows to prevent issues of keyboard sliding up and cover UITextField/UITextView. Neither need to write any code nor any setup required and much more.
hackiftekhar Merge pull request #1407 from andreybog/ab/textView-placeholder-fix
Fixed IQTextView intrinsic size when placeholder text is more than 2 lines.
Latest commit 51c9d6f Aug 9, 2018
Permalink
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update issue templates Jun 28, 2018
Demo.xcodeproj upgraded to 6.0.5 Jul 9, 2018
Demo.xcworkspace - Upgraded to Xcode 9.3 Apr 12, 2018
Demo - Updated to v6.1.1 Jul 18, 2018
DemoObjCUITests Adopted subscript syntax Apr 22, 2016
IQKeyboardManager.xcodeproj - Fixed an issue where textView is at the bottom of iPhone X or on a … Jul 18, 2018
IQKeyboardManager Fixed intrinsic size when placeholder text is more than 2 lines. Aug 8, 2018
IQKeyboardManagerSwift Fixed intrinsic size when placeholder text is more than 2 lines. Aug 8, 2018
Screenshot Add files via upload Nov 20, 2017
.codeclimate.yml Create .codeclimate.yml Oct 15, 2015
.coveralls.yml Create .coveralls.yml Oct 13, 2015
.gitignore Updated .gitignore Jun 4, 2015
.swift-version Converting project to support swift4 Sep 21, 2017
.travis.yml Updated travis.yml and updated search example for iOS11 Mar 14, 2018
CHANGELOG.md Update CHANGELOG.md Apr 17, 2018
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Feb 27, 2018
CONTRIBUTING.md Create CONTRIBUTING.md Feb 27, 2018
IQKeyboardManager.podspec.json - Updated to v6.1.1 Jul 18, 2018
IQKeyboardManagerSwift.podspec.json - Updated to v6.1.1 Jul 18, 2018
ISSUE_TEMPLATE.md Update ISSUE_TEMPLATE.md Jun 28, 2018
LICENSE.md Reformat LICENSE, bump copyright year Oct 19, 2017
PULL_REQUEST_TEMPLATE.md Create PULL_REQUEST_TEMPLATE.md Feb 27, 2018
Podfile Now using pod framework for both version of demo Sep 22, 2017
Podfile.lock Fixed #1342 placeholder layout bug on IQTextView for RTL languages Jun 16, 2018
README.md Update README.md Jun 14, 2018

README.md

Icon

IQKeyboardManager

GitHub license

Build Status

Often while developing an app, We ran into an issues where the iPhone keyboard slide up and cover the UITextField/UITextView. IQKeyboardManager allows you to prevent issues of the keyboard sliding up and cover UITextField/UITextView without needing you to enter any code and no additional setup required. To use IQKeyboardManager you simply need to add source files to your project.

Key Features

  1. **CODELESS**, Zero 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. There are also nice optional features allowing you to customize the distance from the text field, add the next/previous done button as a keyboard UIToolbar, play sounds when the user navigations through the form and more.

Screenshot

IQKeyboardManager Settings

GIF animation

IQKeyboardManager

Video

IQKeyboardManager Demo Video

Tutorial video by @rebeloper (#1135)

@rebeloper demonstrated two videos on how to implement IQKeyboardManager at it's core:

Youtube Tutorial Playlist

https://www.youtube.com/playlist?list=PL_csAAO9PQ8aTL87XnueOXi3RpWE2m_8v

Warning

  • If you're planning to build SDK/library/framework and wants to handle UITextField/UITextView with IQKeyboardManager then you're totally going on wrong way. I would never suggest to add IQKeyboardManager as dependency/adding/shipping with any third-party library, instead of adding IQKeyboardManager you should implement your own solution to achieve same kind of results. IQKeyboardManager is totally designed for projects to help developers for their convenience, it's not designed for adding/dependency/shipping with any third-party library, because doing this could block adoption by other developers for their projects as well(who are not using IQKeyboardManager and implemented their custom solution to handle UITextField/UITextView thought the project).
  • If IQKeyboardManager conflicts with other third-party library, then it's developer responsibility to enable/disable IQKeyboardManager when presenting/dismissing third-party library UI. Third-party libraries are not responsible to handle IQKeyboardManager.

Requirements

Platform iOS

Language Minimum iOS Target Minimum Xcode Version
IQKeyboardManager Obj-C iOS 8.0 Xcode 8.2.1
IQKeyboardManagerSwift Swift iOS 8.0 Xcode 8.2.1
Demo Project Xcode 9.3

Note

  • 3.3.7 is the last iOS 7 supported version.

Swift versions support

Swift Xcode IQKeyboardManagerSwift
4.2, 4.0, 3.2, 3.0 10.0 >= 6.0.4
4.0, 3.2, 3.0 9.0 5.0.0
3.1 8.3 4.0.10
3.0 (3.0.2) 8.2 4.0.8
2.2 or 2.3 7.3 4.0.5
2.1.1 7.2 4.0.0
2.1 7.2 3.3.7
2.0 7.0 3.3.3.1
1.2 6.3 3.3.1
1.0 6.0 3.3.2

Installation

Installation with CocoaPods

CocoaPods

IQKeyboardManager (Objective-C): IQKeyboardManager is available through CocoaPods, to install it simply add the following line to your Podfile: (#9)

pod 'IQKeyboardManager' #iOS8 and later

pod 'IQKeyboardManager', '3.3.7' #iOS7

IQKeyboardManager (Swift): IQKeyboardManagerSwift is available through CocoaPods, to install it simply add the following line to your Podfile: (#236)

Swift 4.2, 4.0, 3.2, 3.0 (Xcode 9)

pod 'IQKeyboardManagerSwift'

Or you can choose version you need based on Swift support table from Requirements

pod 'IQKeyboardManagerSwift', '5.0.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: [NSObject: AnyObject]?) -> Bool {

      IQKeyboardManager.shared.enable = true

      return true
    }
}

Installation with Carthage

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, specify it in 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 according to your need. Make sure to add only one framework and not both.

Installation with Source Code

Github tag

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: [NSObject: AnyObject]?) -> Bool {

      IQKeyboardManager.shared.enable = true

      return true
    }
}

Migration Guide

Other Links

Flow Diagram

IQKeyboardManager CFD

If you would like to see detailed Flow diagram then see Detailed Flow Diagram.

LICENSE

Distributed under the MIT License.

Contributions

Any contribution is more than welcome! You can contribute through pull requests and issues on GitHub.

Author

If you wish to contact me, email at: hack.iftekhar@gmail.com