InputKit

by tingxins

tingxins / InputKit

📝InputKit, an Elegant Kit to limits your input text, inspired by BlocksKit, written in both Objecti...

422 Stars 66 Forks Last release: Not found MIT License 113 Commits 22 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

InputKit is an Elegant Kit to limits your input text, inspired by BlocksKit, written in both Objective-C & Swift.

中文介绍

Language

Installation

There are three ways to use InputKit in your project:

  • Using CocoaPods

  • Manual

  • Using Carthage

CocoaPods

CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries in your projects.

Podfile

platform :ios, '8.0'

Objective-C

pod 'InputKit', '~> 1.1.15'

Swift 3.x

pod 'InputKitSwift', '~> 1.1.14'

Swift 4.0

pod 'InputKitSwift', '~> 1.1.16'

Manual

Download repo's zip, and just drag ALL files in the InputKit folder to your projects.

Carthage

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.

Usage

You can running InputKitDemo for more details.

Using Code

First, import header file when you are using.

#import "InputKit.h"

For UITextField:

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];

inputKit-demo-default

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];

inputKit-demo-price

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-demo-custom

Using Nib

InputKit accessible from the Attributes Inspector. These attributes have been available:

inputKit-demo-inspector-en

About Callback

If you want to get a callback when you are input limited text, you should have to do this:

  1. Set the delegate of your TXLimitedTextField:

    self.limitedTextField.delegate = self;
    
    

  2. 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!"); }

Other

Compatible with ReactiveCocoa

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!👀

Communication

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.

License

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

Ad

Welcome to my Official Account of WeChat.

wechat-qrcode

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.