Clavier

Clavier is Keyboard Layout Guide for iOS. It using an intersection frame to calculate the Layout Guide.

Example

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

Requirements

Swift 5.1 or higher
iOS 10.0 or higher

Installation

Requirements

Swift 5.1 or higher
iOS 10.0 or higher

Cocoapods

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

pod 'Clavier', '~> 2.0.3'

Swift Package Manager from XCode

Add it using XCode menu File > Swift Package > Add Package Dependency
Add https://github.com/hainayanda/Clavier.git as Swift Package URL
Set rules at version, with Up to Next Major option and put 2.0.3 as its version
Click next and wait

Swift Package Manager from Package.swift

Add as your target dependency in Package.swift

dependencies: [
    .package(url: "https://github.com/hainayanda/Clavier.git", .upToNextMajor(from: "2.0.3"))
]

Use it in your target as Clavier

 .target(
    name: "MyModule",
    dependencies: ["Clavier"]
)

Author

Nayanda Haberty, hainayanda@outlook.com

License

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

Basic Usage

Clavier is the Keyboard Layout Guide created to make constraints to the keyboard. It will automatically change on the keyboard changes. It calculates the intersection frame of the Keyboard and the UIView. As you can see in the picture below:

alt text

If the keyboard did not intersect with the view, it will always use the most bottom of the UIView with zero height for the regular one, or most bottom of the safe area when using a safe one

alt text

If the keyboard is hidden, it will always use the most bottom of the UIView with zero height for the regular one, or most bottom of the safe area when using a safe one

Usage

To use Clavier, just use clavierLayoutGuide from any UIView, or safeClavierLayoutGuide if you prefer the one intersect with the safe area. it is an instance of ClavierLayoutGuide class which extend UILayoutGuide so it has all its anchors, like topAnchor, leadingAnchor, etc:

myView.bottomAnchor.constraints(equalTo: mySuperview.clavierLayoutGuide.topAnchor)

or with safe area:

myView.bottomAnchor.constraints(equalTo: mySuperview.safeClavierLayoutGuide.topAnchor)

myView will automatically move according to keyboard layout guide frame changes.

Since its subclass of UILayoutGuide, it has layoutFrame which is the intersection frame with keyboard frame, if you need it:

let frameIntersectWithKeyboard: CGRect = view.clavierLayoutGuide.layoutFrame

or with safe area:

let frameIntersectWithKeyboard: CGRect = view.safeClavierLayoutGuide.layoutFrame

iOS 15

On iOS 15, Clavier will defaultly use keyboardLayoutGuide from UIKit. on safeClavierLayoutGuide, it will use custom class that utilize keyboardLayoutGuide and safeAreaLayoutGuide

You can explicitly disable iOS 15 keyboardLayoutGuide if you want by set directly with the view or by using global config.

myView.usingAppleKeyboardLayoutGuideIfAvailable = false

// or to apply as default with all view

ClavierGlobalConfig.usingAppleKeyboardLayoutGuideIfAvailable = false

Contribute

You know how, just clone and do pull request