整体的目录结构

屏幕快照 2017-04-06 上午8.45.33.png

分批次描述：

屏幕快照 2017-04-06 上午8.44.44.png

cell 文件夹

cell文件夹

没有必要一一讲述，这里就是不同元素，每个元素其实都是UITableViewCell，但是为了统一封装都继承了XLFormBaseCell，最后在统一继承UITableViewCell

Controllers 文件夹

Controllers 文件夹

Descriptors(描述) 文件夹

Descriptors(描述) 文件夹

Helpers(分类) 文件夹

Helpers(分类) 文件夹

Validation(限制) 文件夹

Validation(限制)文件夹

里面可以集成对各个输入的一些限制判断，在其中可以通过正则表达式来限制。
XLFormRegexValidator类为解析正正则表达式，判断出是否符合输入限制，其核心代码

-(XLFormValidationStatus *)isValid: (XLFormRowDescriptor *)row {
    if (row != nil && row.value != nil) {
        // we only validate if there is a value
        // assumption: required validation is already triggered
        // if this field is optional, we only validate if there is a value
        id value = row.value;
        if ([value isKindOfClass:[NSNumber class]]){
            value = [value stringValue];
        }
        if ([value isKindOfClass:[NSString class]] && [value length] > 0) {
            //通过谓词这种高级特性判断输入内容是否符合标准
            BOOL isValid = [[NSPredicate predicateWithFormat:@"SELF MATCHES %@", self.regex] evaluateWithObject:[value stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceCharacterSet]]];
            //将结果建立一个模型
            return [XLFormValidationStatus formValidationStatusWithMsg:self.msg status:isValid rowDescriptor:row];
        }
    }
    return nil;
};

XLFormValidationStatus 其实就是一个是否符合标准的模型。
XLFormValidator判断输入是否符合标准的集合，所有的规则都在其中编写，可以做到很好的复用。
XLFormValidatorProtocol所有的限制规则都要遵守该协议。

下面简述一个限制的判断过程，已判断输入是否为邮箱为例：
首先在创建界面界面阶段要先加上对该条的判断规则

[row addValidator:[XLFormValidator emailValidator]];

然后再** XLFormValidator**中实现该方法

+(XLFormValidator *)emailValidator
{
    return [XLFormRegexValidator formRegexValidatorWithMsg:NSLocalizedString(@"邮箱地址输入有误", nil) regex:@"[A-Z0-9a-z._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,4}"];
}

运行时该条限定条件会添加到该元素的validators 数组中，也就是说，同一个元素可以存在多条限制

-(void)addValidator:(id<XLFormValidatorProtocol>)validator
{
    if (validator == nil || ![validator conformsToProtocol:@protocol(XLFormValidatorProtocol)])
        return;

    if(![self.validators containsObject:validator]) {
        [self.validators addObject:validator];
    }
}

在提交表单的时候，可以进行检查

    NSArray * validationErrors = [self formValidationErrors];
    if (validationErrors.count > 0){
        [self showFormValidationError:[validationErrors firstObject]];
        return;
    }

跳来跳去会跳到-(NSArray *)localValidationErrors:(XLFormViewController *)formViewController函数，内部会把所有元素挨个遍历一遍寻找所有的，把所有不合格的输入都挑出来其中遍历元素的是[row doValidation]方法

- (BOOL)valueIsEmpty
{
    return self.value == nil || [self.value isKindOfClass:[NSNull class]] || ([self.value respondsToSelector:@selector(length)] && [self.value length]==0) ||
    ([self.value respondsToSelector:@selector(count)] && [self.value count]==0);
}

-(XLFormValidationStatus *)doValidation
{
    XLFormValidationStatus *valStatus = nil;

    if (self.required) { //判断输入是否为必须输入，如果为非必输则跳过
        // do required validation here
        if ([self valueIsEmpty]) {//判断元素是否为空
            valStatus = [XLFormValidationStatus formValidationStatusWithMsg:@"" status:NO rowDescriptor:self];
            NSString *msg = nil;
            if (self.requireMsg != nil) {
                msg = self.requireMsg;
            } else {
                // default message for required msg
                msg = NSLocalizedString(@"%@ can't be empty", nil);
            }

            if (self.title != nil) {
                valStatus.msg = [NSString stringWithFormat:msg, self.title];
            } else {
                valStatus.msg = [NSString stringWithFormat:msg, self.tag];
            }

            return valStatus;
        }
    }
    // custom validator   遍历限制规则
    for(id<XLFormValidatorProtocol> v in self.validators) {
        if ([v conformsToProtocol:@protocol(XLFormValidatorProtocol)]) {
            XLFormValidationStatus *vStatus = [v isValid:self];//实现协议的方法 生成一个是否成功的模型
            // fail validation
            if (vStatus != nil && !vStatus.isValid) {
                return vStatus;
            }
            valStatus = vStatus;
        } else {
            valStatus = nil;
        }
    }
    return valStatus;
}

根据这一些列操作就可以判断出是否输入是否符合限制

/**
 遍历所有元素返回不符合输入规则的元素，并且返回相应的错误信息

 @param formViewController formViewController description
 @return return value description
 */
-(NSArray *)localValidationErrors:(XLFormViewController *)formViewController {
    NSMutableArray * result = [NSMutableArray array];
    for (XLFormSectionDescriptor * section in self.formSections) {
        for (XLFormRowDescriptor * row in section.formRows) {
            XLFormValidationStatus* status = [row doValidation];
            if (status != nil && (![status isValid])) {
                NSDictionary *userInfo = @{ NSLocalizedDescriptionKey: status.msg,
                                            XLValidationStatusErrorKey: status };
                NSError * error = [[NSError alloc] initWithDomain:XLFormErrorDomain code:XLFormErrorCodeGen userInfo:userInfo];
                if (error){
                    [result addObject:error];
                }
            }
        }
    }
    
    return result;
}