[](https://travis-ci.org/CRAnimation/CRBoxInputView) [](https://cocoapods.org/pods/CRBoxInputView) [](https://cocoapods.org/pods/CRBoxInputView) [](https://cocoapods.org/pods/CRBoxInputView) ### [中文文档](https://github.com/CRAnimation/CRBoxInputView#Header_Start) [/ English Document](https://github.com/CRAnimation/CRBoxInputView/blob/master/README_en.md#Header_Start) ## Tip - If you fell good. Could you please give me a star? Thank you. ## Feature - Support verify code auto fill in iOS12 - Support `Masonry` - Support security type - Support custom security image / view - Support change code length dynamically > You can use this widget for verify code, password input or phone number input.
I hope you can like this! ## Installation CRBoxInputView is available through [CocoaPods](https://cocoapods.org). To install it, simply add the following line to your Podfile: ```ruby pod 'CRBoxInputView', '1.2.1' ``` ## Example To run the example project, clone the repo, and run `pod install` from the Example directory first.  ## Quick Guide | Type | Image | | :-------------: | :-------------: | | [Base](#Anchor_Base) |  | | [Placeholder](#Anchor_Placeholder) |  | | [CustomBox](#Anchor_CustomBox) |  | | [Line](#Anchor_Line) |  | | [SecretSymbol](#Anchor_SecretSymbol) |  | | [SecretImage](#Anchor_SecretImage) |  | | [SecretView](#Anchor_SecretView) |  | | [ResetCodeLength](#Anchor_ResetCodeLength) |  | ## Usage ### Base  ``` objc CRBoxInputView *boxInputView = [[CRBoxInputView alloc] initWithFrame:CGRectMake(0, 0, 200, 50)]; boxInputView.codeLength = 4; boxInputView.keyBoardType = UIKeyboardTypeNumberPad; [boxInputView loadAndPrepareViewWithBeginEdit:YES]; // BeginEdit: If need begin edit. [self.view addSubview:boxInputView]; // inputType（number） _boxInputView.inputType = CRInputType_Number; // inputType（regex） //_boxInputView.inputType = CRInputType_Regex; //_boxInputView.customInputRegex = @"[^0-9]"; // Get value // func1, call back block when input text did change boxInputView.textDidChangeblock = ^(NSString *text, BOOL isFinished) { NSLog(@"text:%@", text); }; // func2, normal readonly property NSLog(@"textValue:%@", boxInputView.textValue); // Clear all [boxInputView clearAllWithBeginEdit:YES]; // BeginEdit: If need begin edit after clear all. ```
### Placeholder  ``` objc CRBoxInputCellProperty *cellProperty = [CRBoxInputCellProperty new]; cellProperty.cellPlaceholderTextColor = [UIColor colorWithRed:114/255.0 green:116/255.0 blue:124/255.0 alpha:0.3]; //optional cellProperty.cellPlaceholderFont = [UIFont systemFontOfSize:20]; //optional CRBoxInputView *boxInputView = [[CRBoxInputView alloc] initWithCodeLength:4]; boxInputView.ifNeedCursor = NO; //optional boxInputView.placeholderText = @"露可娜娜"; //required boxInputView.customCellProperty = cellProperty; [boxInputView loadAndPrepareViewWithBeginEdit:YES]; ```
### CustomBox  ``` objc CRBoxInputCellProperty *cellProperty = [CRBoxInputCellProperty new]; cellProperty.cellBgColorNormal = color_FFECEC; cellProperty.cellBgColorSelected = [UIColor whiteColor]; cellProperty.cellCursorColor = color_master; cellProperty.cellCursorWidth = 2; cellProperty.cellCursorHeight = 30; cellProperty.cornerRadius = 4; cellProperty.borderWidth = 0; cellProperty.cellFont = [UIFont boldSystemFontOfSize:24]; cellProperty.cellTextColor = color_master; cellProperty.configCellShadowBlock = ^(CALayer * _Nonnull layer) { layer.shadowColor = [color_master colorWithAlphaComponent:0.2].CGColor; layer.shadowOpacity = 1; layer.shadowOffset = CGSizeMake(0, 2); layer.shadowRadius = 4; }; CRBoxInputView *boxInputView = [[CRBoxInputView alloc] initWithCodeLength:4]; boxInputView.boxFlowLayout.itemSize = CGSizeMake(50, 50); boxInputView.customCellProperty = cellProperty; [boxInputView loadAndPrepareViewWithBeginEdit:YES]; ```
### Line  ``` objc CRBoxInputCellProperty *cellProperty = [CRBoxInputCellProperty new]; cellProperty.showLine = YES; //Required cellProperty.customLineViewBlock = ^CRLineView * _Nonnull{ CRLineView *lineView = [CRLineView new]; lineView.underlineColorNormal = [color_master colorWithAlphaComponent:0.3]; lineView.underlineColorSelected = [color_master colorWithAlphaComponent:0.7]; lineView.underlineColorFilled = color_master; [lineView.lineView mas_remakeConstraints:^(MASConstraintMaker *make) { make.height.mas_equalTo(4); make.left.right.bottom.offset(0); }]; lineView.selectChangeBlock = ^(CRLineView * _Nonnull lineView, BOOL selected) { if (selected) { [lineView.lineView mas_updateConstraints:^(MASConstraintMaker *make) { make.height.mas_equalTo(6); }]; } else { [lineView.lineView mas_updateConstraints:^(MASConstraintMaker *make) { make.height.mas_equalTo(4); }]; } }; return lineView; }; //Optional CRBoxInputView *boxInputView = [[CRBoxInputView alloc] initWithCodeLength:4]; boxInputView.customCellProperty = cellProperty; [boxInputView loadAndPrepareViewWithBeginEdit:YES]; ```
### SecretSymbol  ``` objc CRBoxInputCellProperty *cellProperty = [CRBoxInputCellProperty new]; cellProperty.securitySymbol = @"*"; //Optional CRBoxInputView *boxInputView = [[CRBoxInputView alloc] initWithCodeLength:4]; boxInputView.ifNeedSecurity = YES; //Required (You can change this property anytime. And the existing texts can be refreshed automatically.) boxInputView.customCellProperty = cellProperty; [boxInputView loadAndPrepareViewWithBeginEdit:NO]; _boxInputView.ifClearAllInBeginEditing = YES; [_boxInputView reloadInputString:@"5678"]; ```
### SecretImage  ``` objc CRBoxInputCellProperty *cellProperty = [CRBoxInputCellProperty new]; cellProperty.securityType = CRBoxSecurityCustomViewType; //Required cellProperty.customSecurityViewBlock = ^UIView * _Nonnull{ CRSecrectImageView *secrectImageView = [CRSecrectImageView new]; secrectImageView.image = [UIImage imageNamed:@"smallLock"]; secrectImageView.imageWidth = 23; secrectImageView.imageHeight = 27; return secrectImageView; }; //Required CRBoxInputView *boxInputView = [[CRBoxInputView alloc] initWithCodeLength:4]; boxInputView.ifNeedSecurity = YES; //Required (You can change this property anytime. And the existing texts can be refreshed automatically.) boxInputView.customCellProperty = cellProperty; [boxInputView loadAndPrepareViewWithBeginEdit:YES]; ```
### SecretView  ``` objc CRBoxInputCellProperty *cellProperty = [CRBoxInputCellProperty new]; cellProperty.securityType = CRBoxSecurityCustomViewType; //Required cellProperty.customSecurityViewBlock = ^UIView * _Nonnull{ UIView *customSecurityView = [UIView new]; customSecurityView.backgroundColor = [UIColor clearColor]; // circleView static CGFloat circleViewWidth = 20; UIView *circleView = [UIView new]; circleView.backgroundColor = color_master; circleView.layer.cornerRadius = 4; [customSecurityView addSubview:circleView]; [circleView mas_makeConstraints:^(MASConstraintMaker *make) { make.width.height.mas_equalTo(circleViewWidth); make.centerX.offset(0); make.centerY.offset(0); }]; return customSecurityView; }; //Optional CRBoxInputView *boxInputView = [[CRBoxInputView alloc] initWithCodeLength:4]; boxInputView.ifNeedSecurity = YES; //Required (You can change this property anytime. And the existing texts can be refreshed automatically.) boxInputView.customCellProperty = cellProperty; [boxInputView loadAndPrepareViewWithBeginEdit:YES]; ```
### ResetCodeLength  ``` objc [boxInputView resetCodeLength:_boxInputView.codeLength+1 beginEdit:YES]; ```
## Properties And Functions `CRBoxInputCellProperty` ``` objc #pragma mark - UI @property (assign, nonatomic) CGFloat borderWidth; @property (copy, nonatomic) UIColor *cellBorderColorNormal; @property (copy, nonatomic) UIColor *cellBorderColorSelected; @property (copy, nonatomic) UIColor *__nullable cellBorderColorFilled; @property (copy, nonatomic) UIColor *cellBgColorNormal; @property (copy, nonatomic) UIColor *cellBgColorSelected; @property (copy, nonatomic) UIColor *__nullable cellBgColorFilled; @property (assign, nonatomic) CGFloat cornerRadius; #pragma mark - cursor @property (copy, nonatomic) UIColor *cellCursorColor; @property (assign, nonatomic) CGFloat cellCursorWidth; @property (assign, nonatomic) CGFloat cellCursorHeight; #pragma mark - line @property (assign, nonatomic) BOOL showLine; #pragma mark - label @property (copy, nonatomic) UIFont *cellFont; @property (copy, nonatomic) UIColor *cellTextColor; #pragma mark - Security @property (assign, nonatomic) BOOL ifShowSecurity; @property (copy, nonatomic) NSString *securitySymbol; @property (assign, nonatomic) CRBoxSecurityType securityType; #pragma mark - Placeholder @property (copy, nonatomic) UIColor *cellPlaceholderTextColor; @property (copy, nonatomic) UIFont *cellPlaceholderFont; #pragma mark - Block @property (copy, nonatomic) CustomSecurityViewBlock customSecurityViewBlock; @property (copy, nonatomic) CustomLineViewBlock customLineViewBlock; @property (copy, nonatomic) ConfigCellShadowBlock __nullable configCellShadowBlock; ``` `CRBoxFlowLayout` ``` objc @property (assign, nonatomic) BOOL ifNeedEqualGap; @property (assign, nonatomic) NSInteger itemNum; ``` `CRBoxInputView` ``` objc // Security @property (assign, nonatomic) BOOL ifNeedSecurity; @property (assign, nonatomic) CGFloat securityDelay; @property (assign, nonatomic) BOOL ifNeedCursor; @property (nonatomic, assign) NSInteger codeLength; @property (assign, nonatomic) UIKeyboardType keyBoardType; @property (null_unspecified,nonatomic,copy) UITextContentType textContentType NS_AVAILABLE_IOS(10_0); @property (strong, nonatomic) NSString * _Nullable placeholderText; @property (assign, nonatomic) BOOL ifClearAllInBeginEditing; @property (copy, nonatomic) TextDidChangeblock _Nullable textDidChangeblock; @property (copy, nonatomic) TextEditStatusChangeblock _Nullable textEditStatusChangeblock; @property (strong, nonatomic) CRBoxFlowLayout * _Nullable boxFlowLayout; @property (strong, nonatomic) CRBoxInputCellProperty * _Nullable customCellProperty; @property (strong, nonatomic, readonly) NSString * _Nullable textValue; @property (strong, nonatomic) UIView * _Nullable inputAccessoryView; - (void)loadAndPrepareView; - (void)loadAndPrepareViewWithBeginEdit:(BOOL)beginEdit; - (void)reloadInputString:(NSString *_Nullable)value; // Reload string. (You can use this function to set deault value) - (void)clearAll; - (void)clearAllWithBeginEdit:(BOOL)beginEdit; - (UICollectionView *_Nullable)mainCollectionView; - (void)quickSetSecuritySymbol:(NSString *_Nullable)securitySymbol; // You can inherit and call super - (void)initDefaultValue; - (UICollectionViewCell *_Nullable)customCollectionView:(UICollectionView *_Nullable)collectionView cellForItemAtIndexPath:(NSIndexPath *_Nullable)indexPath; ``` `CRBoxInputCell` ``` objc // You can inherit and rewrite - (UIView *)createCustomSecurityView; ``` `CRLineView` ``` objc @property (strong, nonatomic) UIView *lineView; @property (copy, nonatomic) UIColor *underlineColorNormal; @property (copy, nonatomic) UIColor *underlineColorSelected; @property (copy, nonatomic) UIColor *underlineColorFilled; ``` ## Other Problems - [pod search unable find a pod（already solved）](https://github.com/CRAnimation/CRBoxInputView/issues/1 "pod search unable find a pod") - [pod installation failed， [!] Unable to find a specification for CRBoxInputView（already solved）](https://github.com/CRAnimation/CRBoxInputView/issues/2 "pod installation failed， [!] Unable to find a specification for CRBoxInputView") ## Author BearRan, 648070256@qq.com ## Feedback If you have any other problems about this widget, you can tell me by send E-mail or open a issuse. ## License CRBoxInputView is available under the MIT license. See the LICENSE file for more info.