IQKeyboardManager README

The project's README from github.com/hackiftekhar/IQKeyboardManager. As one markdown file: README.md.

Icon

LICENSE.md Build Status Platform iOS CocoaPods Github tag

IQKeyboardManager Objective-C version source code is moved to https://github.com/hackiftekhar/IQKeyboardManagerObjC

Introduction

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.

Key Features

  1. One Line of Code - Just enable and it works
  2. Works Automatically - No manual setup required
  3. No More UIScrollView - Automatically handles scroll views
  4. No More Subclasses - Works with standard UIKit components
  5. No More Manual Work - Handles all edge cases automatically
  6. Modular Architecture - Include only what you need via subspecs

What's Included

Optional Features (via Subspecs)

Subspecs

Now IQKeyboardManagerSwift uses a modular architecture with subspecs. By default, all subspecs are included, but you can include only what you need:

Available Subspecs

Including Specific Subspecs

# Include toolbar example
pod 'IQKeyboardManagerSwift/IQKeyboardToolbarManager'

Screenshot

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

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

Requirements

Minimum iOS Target Minimum Xcode Version
IQKeyboardManagerSwift iOS 13.0 Xcode 13
Demo Project Xcode 15

Swift versions support

Swift Xcode IQKeyboardManagerSwift
5.9, 5.8, 5.7 16 >= 7.0.0
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

Installation

CocoaPods

To install it, simply add the following line to your Podfile: (#236)

pod 'IQKeyboardManagerSwift'

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

pod 'IQKeyboardManagerSwift', '8.0.0'

Carthage

To integrate IQKeyboardManger or IQKeyboardManagerSwift into your Xcode project using Carthage, add the following line to your Cartfile:

github "hackiftekhar/IQKeyboardManager"

Run carthage update --use-xcframeworks to build the frameworks and drag IQKeyboardManagerSwift.xcframework into your Xcode project based on your need. Make sure to add only one framework, not both.

Swift Package Manager (SPM)

To install IQKeyboardManagerSwift package via Xcode

Source Code

IQKeyboardManagerSwift: Source code installation is not supported (since 7.2.0) because now the library depends on some other independent libraries. Due to this you may face compilation issues.

Basic Usage

Minimal Setup (Core Only)

In AppDelegate.swift, import and enable IQKeyboardManager:

import IQKeyboardManagerSwift

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?

    func application(_ application: UIApplication, 
                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

        // Enable keyboard management
        IQKeyboardManager.shared.isEnabled = true

        return true
    }
}

That's it! The keyboard will now automatically adjust to avoid covering text fields.

With Toolbar (Requires IQKeyboardToolbarManager Subspec)

import IQKeyboardManagerSwift

func application(_ application: UIApplication, 
                 didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    // Enable keyboard management
    IQKeyboardManager.shared.isEnabled = true
    
    // Enable toolbar (@Deprecated: Please use IQKeyboardToolbarManager pod independently)
    IQKeyboardManager.shared.enableAutoToolbar = true

    return true
}

With All Features

import IQKeyboardManagerSwift

func application(_ application: UIApplication, 
                 didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    // Core functionality
    IQKeyboardManager.shared.isEnabled = true
    IQKeyboardManager.shared.keyboardDistance = 20.0
    
    // Toolbar (if using IQKeyboardToolbarManager subspec)
    IQKeyboardManager.shared.enableAutoToolbar = true
    
    // Tap to resign (if using Resign subspec)
    IQKeyboardManager.shared.resignOnTouchOutside = true
    
    // Appearance (if using Appearance subspec)
    IQKeyboardManager.shared.keyboardConfiguration.overrideKeyboardAppearance = true
    IQKeyboardManager.shared.keyboardConfiguration.keyboardAppearance = .dark

    return true
}

Migration Guide

Other Links

Dependency Diagram

IQKeyboardManager Dependency 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: [email protected]

IQKeyboardManager (hackiftekhar/IQKeyboardManager)

Searching Database…

16.6K ·GitHub
IQKeyboardManager
Что это такое?IQKeyboardManager — готовая к подключению библиотека для iOS, которая автоматически не даёт клавиатуре подниматься и перекрывать UITextField или UITextView. Никакого кода или ручной настройки не требуется.
Это фреймворк, под который нужно перестраивать проект, или просто библиотека, которую достаточно подключить?Это легковесная библиотека, которую достаточно подключить: вы добавляете её в проект и включаете одной строкой кода, а она сама берёт на себя задачу, чтобы клавиатура не перекрывала поля, для стандартных компонентов UIKit.
Как добавить её в мой проект?Установка через CocoaPods (добавьте строку в Podfile), Carthage (добавьте в Cartfile и выполните 'carthage update --use-xcframeworks') или Swift Package Manager через диалог Xcode «Add Package Dependency». Затем включите её в AppDelegate.swift.
Нужна ли мне определённая версия Xcode или iOS?IQKeyboardManagerSwift требует минимальную цель iOS 13.0 и Xcode 13. Поддержка версий Swift указана в таблице совместимости.
Есть ли подводные камни при установке, о которых мне стоит знать?Начиная с версии 7.2.0 установка из исходного кода не поддерживается, так как библиотека теперь зависит от других независимых библиотек, что может вызывать ошибки компиляции. Используйте CocoaPods, Carthage или SPM.
Можно ли использовать её внутри моего SDK или сторонней библиотеки?Нет. Автор прямо предупреждает, что IQKeyboardManager нельзя поставлять как зависимость другого SDK, библиотеки или фреймворка. Она предназначена для проектов приложений, а не для встраивания в сторонние библиотеки.
Что будет, если она конфликтует со сторонней библиотекой для интерфейса?Разработчик сам отвечает за то, чтобы вручную включать или выключать IQKeyboardManager при показе или скрытии этого стороннего интерфейса, так как сторонняя библиотека сама этого не сделает.
Могу ли я подключить только нужные части библиотеки, а не всё целиком?Да, библиотека построена на модульной архитектуре subspec: модуль Core подключается всегда, а при необходимости можно добавить Appearance, IQKeyboardReturnManager, IQKeyboardToolbarManager, IQTextView или Resign в зависимости от нужных функций.
Есть ли в ней панель с кнопками Previous/Next/Done?Да, это доступно как необязательный subspec IQKeyboardToolbarManager, а не входит в модуль Core.
Есть ли ещё поддержка версии на Objective-C?Исходный код версии на Objective-C перенесён в другое место и больше не поддерживается в этом репозитории, который ориентирован на Swift.
What are similar projects?Spring, AFNetworking, SVProgressHUD, FSCalendar, SwiftyJSON, Eureka, FLEX, chameleon
Which topics is it in?appkit, swift-library, productivity-tools, cocoapods, keyboard, objective-c, xcode, apple, swift, sdk, utility, mobile
Creator
hackiftekhar
Size
24.8 MB
Stars
16.6K
Updated
CommitMay 25Release8.0.3May 25
Age
13y
Commits · 90 Days