Often while developing an app the iPhone keyboard slide up and cover the UITextField/UITextView. BHTextFieldManager allows you to prevent issues of the keyboard sliding up and cover UITextField/UITextView without needing you to enter any extra code. To use BHTextFieldManager you simply need to add Framework file to your project.
-
Set the keyboard navigation for perticular view -
It is worked even the textfields/textviews are placed at different different views and any sequance because it is works on textfield's tag. -
Get the Up,Down and Done button's actions by the delegates for performing tasks -
Set Arrow button and Done button and background view colors according to your theme -
Set done button's text as you want and hide and shows up down arrows as your need.
BHTextFieldManager works on all orientations, and with the toolbar. There are also nice optional features allowing you to customize the distance from the text field, add the next/previous done button as a keyboard UIToolbar and set the colors, also can change the text of done button. You can get the all up/down and done button's click event by calling the delegates. you can hide and show up/down arrows as your need.
CocoaPods is a dependency manager for Cocoa projects. You can install framerowk with the following steps:
- Installing Cocoapods -> Run bellow command for installing cocoapods into your PC.
$ sudo gem install cocoapods
- Create new project -> Run bellow command for going to the project directory.
$ cd YourProjectDirectoryPath
- Create a podfile -> Run bellow command for creating a pod file(if you have not created)
$ pod init
- Write Pod comment to the pod file -> Write bellow lines into the generated Podfile into your project.
pod 'BHTextFieldManager'
- Install cocoapods -> Save Podfile and Run bellow command for installing BHTextFieldManager to your project by cocoapods.
$ pod install
-
Open project -> Now go to your project directory and open .xcworkspace file.
-
Build Project -> Build your project and write import statement and use BHTextFieldManager whereever you want in your project.
- (i) Create a new project: File → New → Project. Select iOS and choose “Single View Application” and click “Next”. And set options like Product Name, Team, etc. and create the Project.
(ii) Set the Framework Dependencies: Copy/Drag the Universal Framework to this project.
While coping the framework in Project Explorer, check “Copy items if needed”.
(iii) Select the Project, Choose Target → Project Name → Select General → Scroll to “Embedded Binaries”. Press “+” and Add the framework.
-
set the textfields/textviews and give a tag from 101 to N in order to navigate the textfields sequance.
-
In new version now there is not needed to add delegates to the textfields and textviews.
-
Setup the framework and see the demo projects for full usage and installation.
-
For the setup and setting up the framework use other methods.
Objective C
ViewController.h
--------------------------------
#import <UIKit/UIKit.h>
#import <BHTextFieldManager/BHTextFieldManager.h>
@interface ViewController : UIViewController<BHTextFieldManagerDelegate>
@end
ViewController.m
---------------------------------
#import "ViewController.h"
@interface ViewController ()
{
BHTextFieldManager *BHFramework;
}
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
// Do any additional setup after loading the view, typically from a nib.
//Setup the BHTextFieldManager.
BHFramework = [[BHTextFieldManager alloc] init];
BHFramework.delegate = self;
[BHFramework setEnable:self.view];
}
//TODO: BHTextFieldManagerDelegate Methods
-(void)upKeyBoardBtn:(id)sender isLastTextFieldOrTextView:(enum senderIDType)type {
//Do Something...
if (type == TextField) {
NSLog(@"Sender(UITextField)'s First Responder is Resign, and Up Button Clicked");
}
else {
NSLog(@"Sender(UITextView)'s First Responder is Resign, and Up Button Clicked");
}
}
-(void)downKeyBoardBtn:(id)sender isLastTextFieldOrTextView:(enum senderIDType)type {
switch (type) {
case TextField:
NSLog(@"Sender(UITextField)'s First Responder is Resign, and Down Button Clicked");
break;
case TextView:
NSLog(@"Sender(UITextView)'s First Responder is Resign, and Down Button Clicked");
break;
}
}
-(void)doneKeyBoardBtn:(id)sender isLastTextFieldOrTextView:(enum senderIDType)type {
//Do Something...
NSLog(@"Sender's First Responder is Resign, and Done Button Clicked");
}
//Error Showing Method
-(void)isErrorOrNot:(BOOL)isError withError:(NSString *)error {
//You will get the error here and you can pull/comment to me on github.
NSLog(@"Error: %@",error);
}
- (void)didReceiveMemoryWarning {
[super didReceiveMemoryWarning];
// Dispose of any resources that can be recreated.
}
@end
Swift
Note: For swift you also can make Bridging Header file and can directly use anywhere and use bellow code.
import UIKit
import BHTextFieldManager
class ViewController: UIViewController, BHTextFieldManagerDelegate {
var BHFramework = BHTextFieldManager() //allocation
override func viewDidLoad() {
super.viewDidLoad()
// Do any additional setup after loading the view, typically from a nib.
//Setup the BHTextFieldManager.
BHFramework.delegate = self
BHFramework.setEnable(self.view)
}
//TODO: BHTextFieldManagerDelegate Methods
func upKeyBoardBtn(_ sender: Any!, isLastTextFieldOrTextView type: senderIDType) {
if type == .TextField {
print("Sender(UITextField)'s First Responder is Resign, and Up Button Clicked")
}
else {
print("Sender(UITextView)'s First Responder is Resign, and Up Button Clicked")
}
}
func downKeyBoardBtn(_ sender: Any!, isLastTextFieldOrTextView type: senderIDType) {
switch type {
case .TextField:
print("Sender(UITextField)'s First Responder is Resign, and Down Button Clicked")
case .TextView:
print("Sender(UITextView)'s First Responder is Resign, and Down Button Clicked")
}
}
func doneKeyBoardBtn(_ sender: Any!, isLastTextFieldOrTextView type: senderIDType) {
print("Sender's First Responder is Resign, and Done Button Clicked")
}
//Error Showing Method
func isErrorOrNot(_ isError: Bool, withError error: String?) {
//You will get the error here and you can pull/comment to me on github.
print("Error: \(error ?? "Error")")
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
// Dispose of any resources that can be recreated.
}
}
If you are not using cocoapos and install framework manually then please note there is a two types of framework files. One is only for iPhone Device/Generic Devices and second is run on both iPhone Device/Simulator. When you publish or archive the app on appstore please use or rplace the framework file to "FrameworkForDeviceOnly" framework file otherwise it creates an error for architecture.
To remove that replacement of the framework you can simply write bellow script in the run script and use Universal Framework.
#!/bin/sh
# Script.sh
#
# Created by Bhavik's Mac on 18/07/18.
# Copyright © 2018 Bhavik Barot. All rights reserved.
APP_PATH="${TARGET_BUILD_DIR}/${WRAPPER_NAME}"
# This script loops through the frameworks embedded in the application and
# removes unused architectures.
find "$APP_PATH" -name 'BHTextFieldManager.framework' -type d | while read -r FRAMEWORK
do
FRAMEWORK_EXECUTABLE_NAME=$(defaults read "$FRAMEWORK/Info.plist" CFBundleExecutable)
FRAMEWORK_EXECUTABLE_PATH="$FRAMEWORK/$FRAMEWORK_EXECUTABLE_NAME"
echo "Executable is $FRAMEWORK_EXECUTABLE_PATH"
EXTRACTED_ARCHS=()
for ARCH in $ARCHS
do
echo "Extracting $ARCH from $FRAMEWORK_EXECUTABLE_NAME"
lipo -extract "$ARCH" "$FRAMEWORK_EXECUTABLE_PATH" -o "$FRAMEWORK_EXECUTABLE_PATH-$ARCH"
EXTRACTED_ARCHS+=("$FRAMEWORK_EXECUTABLE_PATH-$ARCH")
done
echo "Merging extracted architectures: ${ARCHS}"
lipo -o "$FRAMEWORK_EXECUTABLE_PATH-merged" -create "${EXTRACTED_ARCHS[@]}"
rm "${EXTRACTED_ARCHS[@]}"
echo "Replacing original executable with thinned version"
rm "$FRAMEWORK_EXECUTABLE_PATH"
mv "$FRAMEWORK_EXECUTABLE_PATH-merged" "$FRAMEWORK_EXECUTABLE_PATH"
done
- Create new run script: Select the Project, Choose Target → Project Name → Build Phase → Press “+” and Add the Run Script.
- Write above script in the run script box.
Distributed under the MIT License.
You can contribute through suggestion or pointing out an issues on GitHub or on a Mail.
Bhavik Barot , email at: barotbhavik23@gmail.com