Skip to content

riosc/InputHandler

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CRInputHandler

[![CI Status](http://img.shields.io/travis/Carlos Rios/CRInputHandler.svg?style=flat)](https://travis-ci.org/Carlos Rios/CRInputHandler) Version License Platform

CRInputHandler is a UI Helper class that facilitates the re-location (if needed) of inputs texts like UITextField and UITextView in iOS applications when it is on focus state. If have worked with forms in iOS aplications before, you could note that sometimes the iOS keyboard overlap the input text making a little painful the user experience. So this class helps you to keep always visible the input when it is on focus. Also this class manages the user tap actions outside input text views to hide the keyboard.

This class works observing the events of UITextField and UITextView classes, so it does not override any delegate method of these UIKit Component.

Life WITH CRInputHandler

input handler image yes

Life WITHOUT CRInputHandler

input handler image not

Usage

You need to put your inputs texts inside a UIScrollView and use the -(id)initWithContainer: to init the class. Your view herarchy should looks similar like this:

 * UIView
 * |-UIScrollView
 * |--UIView
 * |  | |-UITextField
 * |  | |-UITextView
 * |--

The main goals is set the inputs views inside UIScrollView container.

Code Example:

@interface CRViewController ()
{
__weak IBOutlet UITextField * firstNameTF;
__weak IBOutlet UITextField * lastNameTF;
__weak IBOutlet UITextView * bioTV;
__weak IBOutlet UITextField * emailTF;
__weak IBOutlet UITextField * birthdayTF;

__weak IBOutlet UIScrollView * container;

}

@property (nonatomic, strong) CRInputHandler * inputHandler;
@property (nonatomic, strong) NSArray * allInputs;
@end

@implementation CRViewController

- (void)viewDidLoad {
[super viewDidLoad];

_allInputs      = @[firstNameTF, lastNameTF, bioTV, emailTF, birthdayTF];
_inputHandler   = [[CRInputHandler alloc] initWithContainer:container];
[_inputHandler setFields:_allInputs];

}

If you want take a look to Example project. To run the example project, clone the repo, and run pod update or pod install from the Example directory first.

Requirements

iOS 6 or higher

Installation

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

pod "CRInputHandler"

and import it in your class:

#import <CRInputHandler/CRInputHandler.h>

Author

Carlos Rios, rioscarlosd@gmail.com

License

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

About

Class that manages onFocus inputs iOS

Resources

License

Stars

Watchers

Forks

Packages

No packages published