CRBoxInputView/PodCode/Classes/CRBoxInputView.h

//
//  CRBoxInputView.h
//  CRBoxInputView
//
//  Created by Chobits on 2019/1/3.
//  Copyright © 2019 Chobits. All rights reserved.
//

#import <UIKit/UIKit.h>
#import "CRBoxFlowLayout.h"
#import "CRBoxInputCellProperty.h"
#import "CRBoxInputCell.h"
@class CRBoxInputView;

typedef NS_ENUM(NSInteger, CRTextEditStatus) {
    CRTextEditStatus_Idle,
    CRTextEditStatus_BeginEdit,
    CRTextEditStatus_EndEdit,
};

typedef NS_ENUM(NSInteger, CRInputType) {
    /// 数字
    CRInputType_Number,
    /// 普通（不作任何处理）
    CRInputType_Normal,
    /// 自定义正则（此时需要设置customInputRegex）
    CRInputType_Regex,
};

typedef void(^TextDidChangeblock)(NSString * _Nullable text, BOOL isFinished);
typedef void(^TextEditStatusChangeblock)(CRTextEditStatus editStatus);

@interface CRBoxInputView : UIView

/**
 是否需要光标
 ifNeedCursor
 default: YES
 */
@property (assign, nonatomic) BOOL ifNeedCursor;

/**
 验证码长度
 codeLength
 default: 4
 */
@property (nonatomic, assign, readonly) NSInteger codeLength; //If you want to set codeLength, please use `- (instancetype)initWithCodeLength:(NSInteger)codeLength, or - (void)resetCodeLength:(NSInteger)codeLength beginEdit:(BOOL)beginEdit` in CRBoxInputView.

/**
 是否开启密文模式
 描述：你可以在任何时候修改该属性，并且已经存在的文字会自动刷新。
 ifNeedSecurity
 desc: You can change this property anytime. And the existing texts can be refreshed automatically.
 default: NO
 */
@property (assign, nonatomic) BOOL ifNeedSecurity;

/**
 显示密文的延时时间
 securityDelay
 desc: show security delay time
 default: 0.3
 */
@property (assign, nonatomic) CGFloat securityDelay;

/**
 键盘类型
 keyBoardType
 default: UIKeyboardTypeNumberPad
 */
@property (assign, nonatomic) UIKeyboardType keyBoardType;

/**
 输入样式
 inputType
 default: CRInputType_Number
 */
@property (assign, nonatomic) CRInputType inputType;

/**
自定义正则匹配输入内容
customInputRegex
default: @""
当inputType == CRInputType_Regex时才会生效
*/
@property (copy, nonatomic) NSString * _Nullable customInputRegex;

/**
 textContentType
 描述: 你可以设置为 'nil' 或者 'UITextContentTypeOneTimeCode' 来自动获取短信验证码
 desc: You set this 'nil' or 'UITextContentTypeOneTimeCode' to auto fill verify code.
 default: nil
 */
@property (null_unspecified,nonatomic,copy) UITextContentType textContentType NS_AVAILABLE_IOS(10_0);

/**
 占位字符填充值
 说明：在对应的输入框没有内容时，会显示该值。
 默认：nil
 */
@property (strong, nonatomic) NSString  * _Nullable placeholderText;

/**
 弹出键盘时，是否清空所有输入
 只有在输入的字数等于codeLength时，生效
 default: NO
 */
@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;

/**
 装载数据和准备界面
 desc: Load and prepareView
 beginEdit: 自动开启编辑模式
 default: YES
 */
- (void)loadAndPrepareView;
- (void)loadAndPrepareViewWithBeginEdit:(BOOL)beginEdit;

/**
 重载输入的数据（用来设置预设数据）
 desc:Reload string. (You can use this function to set deault value)
 */
- (void)reloadInputString:(NSString *_Nullable)value;

/**
 清空输入
 desc: Clear all
 beginEdit: 自动开启编辑模式
 default: YES
 */
- (void)clearAll;
- (void)clearAllWithBeginEdit:(BOOL)beginEdit;

- (UICollectionView *_Nullable)mainCollectionView;

// 快速设置
// Qiuck set
- (void)quickSetSecuritySymbol:(NSString *_Nullable)securitySymbol;

// 你可以在继承的子类中调用父类方法
// You can inherit and call super
- (void)initDefaultValue;

// 你可以在继承的子类中重写父类方法
// You can inherit and rewrite
- (UICollectionViewCell *_Nullable)customCollectionView:(UICollectionView *_Nullable)collectionView cellForItemAtIndexPath:(NSIndexPath *_Nullable)indexPath;

// code Length 调整
- (void)resetCodeLength:(NSInteger)codeLength beginEdit:(BOOL)beginEdit;

// Init
- (instancetype _Nullable )initWithCodeLength:(NSInteger)codeLength;

@end