An elegant solution for keeping any UIView visible when the keyboard is being shown
IHKeyboardAvoiding will translate any UIView up when the keyboard is being shown, then return it when the keyboard is hidden.
Register an avoidingView
(UIView) with IHKeyboardAvoiding; when the keyboard is shown, if the avoidingView's
frame will be intersected by the keyboard, then it will move up just above the keyboard. When the keyboard is dismissed, the avoidingView
is returned to its original position.
What sets IHKeyboardAvoiding apart from other keyboard avoiding solutions is that it doesn't require placing your content in a UIScrollView. No scroll view is used. And it isn't restricted to keeping UITextFields visible, with IHKeyboardAvoiding any UIView can avoid the keyboard
If Autolayout is used then the constraints are animated, otherwise a CGAffine translation is done.
- iPhone keyboard
- iPad docked keyboard
- iPad undocked keyboard
- iPad split keyboard
- landscape & protrait
- 3rd party keyboards
- Auto Layout
- AutoResizingMask (Springs & Struts)
Add this to your CocoaPods Podfile.
pod 'IHKeyboardAvoiding'
To set the avoiding view
[IHKeyboardAvoiding setAvoidingView:(UIView *)avoidingView];
Put it in (void)viewDidLoad
or (void)viewDidAppear:(BOOL)animated
depending on your usage
If you're unsure put it in (void)viewDidAppear:(BOOL)animated
If you need to set the avoidingView, or its properites, dynamically consider putting it in (BOOL)textViewShouldBeginEditing:(UITextView *)textView
Optional methods
(void)setAvoidingView:(UIView *)avoidingView withTriggerView:(UIView *)triggerView
Use this to set an avoidingView but have a different view that triggers the avoiding. If a triggerView's frame will be intersected by the keyboard, then the avoidingView will be moved so that the triggerView is above the keyboard
(void)setBuffer:(int)buffer
The avoidingView will move if the keyboard is within [buffer] points of the triggerView's frame. Default buffer is 0
(void)setPaddingForCurrentAvoidingView:(int)padding
The padding to put between the keyboard and triggerView. Default padding is 0
Tap to dismiss the keyboard with IHKeyboardDismissing https://github.com/IdleHandsApps/IHKeyboardDismissing
UIScrollView pros:
- They're quick n easy
IHKeyboardAvoiding pros:
- You dont have scrollviews littered throughout your app
- Having multiple scrollviews in your view heirarchy can cause problems
- When the keyboard hides, scrollviews dont always scroll back to their original position
- Scrollviews only scroll enough to keep the focused textfield visible
- IHKeyboardAvoiding provides control over which UIViews are visible when the keyboard appears
https://github.com/michaeltyson/TPKeyboardAvoiding (UIScrollView based)
https://github.com/kirpichenko/EKKeyboardAvoiding (UIScrollView based)
https://github.com/robbdimitrov/RDVKeyboardAvoiding (UIScrollView based)
https://github.com/hackiftekhar/IQKeyboardManager (looks interesting)
https://github.com/danielamitay/DAKeyboardControl (looks interesting)
- Fraser Scott-Morrison (fraserscottmorrison@me.com)
It'd be great to hear about any cool apps that are using IHKeyboardAvoiding
Distributed under the MIT License
- Improve demo project
In iOS8 for iPad, when splitting/undocking the keyboard the notifications arent reliably sent by the OS meaning IHKeyboardAvoiding can be left in the wrong state A radar has been filed http://openradar.appspot.com/18010127