InputKit is an Elegant Kit to limits your input text, inspired by BlocksKit, written in both Objective-C & Swift.
There are three ways to use InputKit in your project:
-
Using CocoaPods
-
Manual
-
Using Carthage
CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries in your projects.
platform :ios, '8.0'
pod 'InputKit', '~> 1.1.15'
pod 'InputKitSwift', '~> 1.1.14'
pod 'InputKitSwift', '~> 1.1.16'
Download repo's zip, and just drag ALL files in the InputKit folder to your projects.
Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.
You can install Carthage with Homebrew using the following command:
$ brew update
$ brew install carthage
To integrate InputKit or InputKitSwift into your Xcode project using Carthage, specify it in your Cartfile:
github "tingxins/InputKit"
Run carthage to build the frameworks and drag the appropriate framework (InputKit.framework or InputKitSwift.framework) into your Xcode project according to your need. Make sure to add only one framework and not both.
You can running InputKitDemo for more details.
First, import header file when you are using.
#import "InputKit.h"
Using TXLimitedTextField class instead.
TXLimitedTextFieldTypeDefault:
The type of TXLimitedTextFieldTypeDefault is just limits the number of characters for TXLimitedTextField that you input, and you can input any characters if you wanted, such as Chinese, Alphabet or Special Characters, e.g.
Example:
TXLimitedTextField *textField = [[TXLimitedTextField alloc] initWithFrame:CGRectMake(20, 200, 100, 30)];
// Of course, you can ignored this line of codes. TXLimitedTextFieldTypeDefault is default.
textField.limitedType = TXLimitedTextFieldTypeDefault;
// this means, you can only input ten characters. It limits the max number of characters that you input.
textField.limitedNumber = 10;
[self.view addSubview:textField];
TXLimitedTextFieldTypePrice:
The type of TXLimitedTextFieldTypePrice is not only limits the number of characters that you input, and can do more useful limited for your textfield. we usually used in TXLimitedTextField that only need to input int or decimal number.
Example:
TXLimitedTextField *textField = [[TXLimitedTextField alloc] initWithFrame:CGRectMake(20, 200, 100, 30)];
// Type
textField.limitedType = TXLimitedTextFieldTypePrice;
// you can also set the property in this type. It limits the max number of characters that you input
textField.limitedNumber = 10;
// this means, that only five ints can be inputted
textField.limitedPrefix = 5;
// this means, that only five decimal can be inputted
textField.limitedSuffix = 2;
[self.view addSubview:textField];
TXLimitedTextFieldTypeCustom:
This type of TXLimitedTextFieldTypeCustom is interesting. you can custom your own TXLimitedTextField, just using your regular expression. but some notes must be noticed when you using.
Example:
TXLimitedTextField *textField = [[TXLimitedTextField alloc] initWithFrame:CGRectMake(20, 200, 100, 30)];
// Of course, you can custom your field
textField.limitedType = TXLimitedTextFieldTypeCustom;
// you can also set the property in this type. It limits the max number of characters that you input
textField.limitedNumber = 10;
// limitedRegExs is a type of array argument that you can via it, and pass your regular expression to TXLimitedTextField. kTXLimitedTextFieldChineseOnlyRegex is a constant that define in TXMatchConst.h file. it's represent that only Chinese characters can be inputted.
textField.limitedRegExs = @[kTXLimitedTextFieldChineseOnlyRegex];
[self.view addSubview:textField];
InputKit accessible from the Attributes Inspector. These attributes have been available:
If you want to get a callback when you are input limited text, you should have to do this:
-
Set the delegate of your TXLimitedTextField:
self.limitedTextField.delegate = self; -
Implement -inputKitDidLimitedIllegalInputText: method:
#pragma mark - InputKit - (void)inputKitDidLimitedIllegalInputText:(id)obj { NSLog(@"If you are input text that limited. this method will be callback. you may do some here!"); }
If you are using ReactiveCocoa in your Projects, please do make sure to set instance property of compatibleWithRAC = YES.(default is NO). Thanks for @devcxm open this issue in GitHub.
Sample Code:
TXLimitedTextView *limitedTextView = [[TXLimitedTextView alloc] initWithFrame:CGRectMake(20.f, 100.f, 120.f, 30.f)];
// If you are using `ReactiveCocoa` somewhere in your Projects, please make sure this property = YES
limitedTextView.compatibleWithRAC = YES;
limitedTextView.delegate = self;
limitedTextView.limitedNumber = 5;
[self.view addSubview:limitedTextView];
[limitedTextView.rac_textSignal subscribeNext:^(NSString * _Nullable x) {
NSLog(@"come here ... %@", x);
}];
//....Enjoy it!👀
Absolutely，you can contribute to this project all the time if you want to.
-
If you need help or ask general question, just @tingxins in Weibo or Twitter, ofcourse, you can access to my blog.
-
If you found a bug, just open an issue.
-
If you have a feature request, just open an issue.
-
If you want to contribute, fork this repository, and then submit a pull request.
InputKit is available under the MIT license. See the LICENSE file for more info.
Welcome to my Official Account of WeChat.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent