Keyboardy

Description

Keyboardy extends UIViewController with few simple methods and provides delegate for handling keyboard appearance notifications.

• Keyboardy is just wrapper on UIKeyboardWillShowNotification and UIKeyboardWillHideNotification notifications.
• Supports both AutoLayout and frame-based animations.
• Swift implementation.
• Without any hacks like method swizzling and magic numbers (ex., curve << 16).

Usage

• Import Keyboardy module

import Keyboardy

• Register for keyboard notifications

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)

    registerForKeyboardNotifications(self)
}

• Unregister from keyboard notifications

override func viewWillDisappear(_ animated: Bool) {
    super.viewWillDisappear(animated)

    unregisterFromKeyboardNotifications()
}

• Implement KeyboardStateDelegate

extension ViewController: KeyboardStateDelegate {

    func keyboardWillTransition(_ state: KeyboardState) {
        // keyboard will show or hide
    }

    func keyboardTransitionAnimation(_ state: KeyboardState) {
        switch state {
        case .activeWithHeight(let height):
            textFieldContainerBottomConstraint.constant = height
        case .hidden:
            textFieldContainerBottomConstraint.constant = 0.0
        }

        view.layoutIfNeeded()
    }

    func keyboardDidTransition(_ state: KeyboardState) {
        // keyboard animation finished
    }
}

Example

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

Requirements

Swift 5, iOS 8

Installation via CocoaPods

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

pod "Keyboardy"

Installation via Carthage

Carthage is a decentralized dependency manager that automates the process of adding frameworks to your Cocoa application.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate Keyboardy into your Xcode project using Carthage, specify it in your Cartfile:

github "podkovyrin/Keyboardy"

Installation via Accio

1. Add the following to your Package.swift:

   .package(url: "https://github.com/podkovyrin/Keyboardy.git", .upToNextMajor(from: "0.2.7")),

2. Next, add Keyboardy to your App targets dependencies like so:

   .target(name: "App", dependencies: ["Keyboardy"]),

3. Then run accio update.

Author

Andrew Podkovyrin, [email protected]

License

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