hackiftekhar/iqkeyboardtoolbarmanager

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Installation

Swift Package Manager (Recommended)

IQKeyboardToolbarManager is available through Swift Package Manager.

Requirements: iOS 13.0+, Swift 5.7+

Using Xcode:

1. In Xcode, go to File → Add Package Dependencies...
2. Enter the repository URL: https://github.com/hackiftekhar/IQKeyboardToolbarManager
3. Select the version rule (e.g., "Up to Next Major Version")
4. Click Add Package
5. Select the IQKeyboardToolbarManager library and click Add Package

Using Package.swift:

Add the following dependency to your Package.swift file:

dependencies: [
    .package(url: "https://github.com/hackiftekhar/IQKeyboardToolbarManager", from: "1.1.3")
]

Then add IQKeyboardToolbarManager to your target dependencies:

.target(
    name: "YourTarget",
    dependencies: ["IQKeyboardToolbarManager"]
)

CocoaPods

IQKeyboardToolbarManager is also available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'IQKeyboardToolbarManager'

Carthage

Add the following line to your Cartfile:

github "hackiftekhar/IQKeyboardToolbarManager"

Usage

After adding IQKeyboardToolbarManager to your project, import it and enable toolbar handling in AppDelegate:

import UIKit
import IQKeyboardToolbarManager

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        IQKeyboardToolbarManager.shared.isEnabled = true
        return true
    }

Cuistomize Behavior

        IQKeyboardToolbarManager.shared.toolbarConfiguration.useTextInputViewTintColor = true
        IQKeyboardToolbarManager.shared.toolbarConfiguration.tintColor = UIColor.systemGreen
        IQKeyboardToolbarManager.shared.toolbarConfiguration.barTintColor = UIColor.systemYellow
        IQKeyboardToolbarManager.shared.toolbarConfiguration.previousNextDisplayMode = .alwaysShow
        IQKeyboardToolbarManager.shared.toolbarConfiguration.manageBehavior = .byPosition

        IQKeyboardToolbarManager.shared.toolbarConfiguration.previousBarButtonConfiguration = ... // BarButton configuration to change title, image or system image etc
        IQKeyboardToolbarManager.shared.toolbarConfiguration.nextBarButtonConfiguration = ... // BarButton configuration to change title, image or system image etc
        IQKeyboardToolbarManager.shared.toolbarConfiguration.doneBarButtonConfiguration = ... // BarButton configuration to change title, image or system image etc

        IQKeyboardToolbarManager.shared.toolbarConfiguration.placeholderConfiguration.showPlaceholder = false
        IQKeyboardToolbarManager.shared.toolbarConfiguration.placeholderConfiguration.font = UIFont.italicSystemFont(ofSize: 14)
        IQKeyboardToolbarManager.shared.toolbarConfiguration.placeholderConfiguration.color = UIColor.systemPurple
        IQKeyboardToolbarManager.shared.toolbarConfiguration.placeholderConfiguration.buttonColor = UIColor.systemBrown // This is used only if placeholder is an action button

        IQKeyboardToolbarManager.shared.playInputClicks = false

        IQKeyboardToolbarManager.shared.disabledToolbarClasses.append(ChatViewController.self)
        IQKeyboardToolbarManager.shared.enabledToolbarClasses.append(LoginViewController.self)
        IQKeyboardToolbarManager.shared.deepResponderAllowedContainerClasses.append(UIStackView.self)

Useful functions and variables

        if IQKeyboardToolbarManager.shared.canGoPrevious {
          ...
        }

        if IQKeyboardToolbarManager.shared.canGoNext {
          ...
        }

        IQKeyboardToolbarManager.shared.goPrevious()
        IQKeyboardToolbarManager.shared.goNext()

        IQKeyboardToolbarManager.shared.reloadInputViews() // If some textInputView hierarchy are changed on the fly then use this to reload button states

Useful functions and variables for TextInputView

        textField.iq.ignoreSwitchingByNextPrevious = false

Author

Iftekhar Qurashi hack.iftekhar@gmail.com

License

IQKeyboardToolbarManager is available under the MIT license. See the LICENSE file for more info.

Package Metadata

Repository: hackiftekhar/iqkeyboardtoolbarmanager

Default branch: main

README: README.md