XLForm 框架学习笔记（持续更新......）

       最近公司要做新项目，趁着现在不忙赶紧将一些知识点提前储备下，由于产品是一款安全产品，需要输入好多信息而且产品的需求又非常细，所以想讲页面做成那种可以配置的，期初简直是让我蛋都碎了，不过还好有强大的github，找到了这个XLForm，它可以方便的进行配置界面省时省力，所以将了解到的东西赶紧记下来，以后好方便开发

• Multivalued sections（增加，删除，移动行）

任何的XLFormSectionDescriptor对象都支持增加，删除，移动行数据，模式是可以配置的首先先是建立一组数据API：

    section = [XLFormSectionDescriptor formSectionWithTitle:@"Multivalued TextField"                                       sectionOptions:  XLFormSectionOptionCanReorder|XLFormSectionOptionCanInsert | XLFormSectionOptionCanDelete                                       sectionInsertMode:XLFormSectionInsertModeButton];

如上面所示，第二个参数可以根据配置得到支持任何增删改的组合形式

                      第三个参数为增加的行数据进入界面的方式，XLFormSectionInsertModeLastRow (从右向左滑动进入) XLFormSectionInsertModeButton(从上到下进入)  第一个为默认参数

动态添加例子

- (id)init{    XLFormDescriptor * form; //建立表单，等同于创建uitableview    XLFormSectionDescriptor * section;//建立组  section    XLFormRowDescriptor * row;//建立行相当于cell        //动态的将要添加一下行添加到组里    NSArray * nameList =@[@"family",@"male",@"female",@"client"];        form = [XLFormDescriptorformDescriptorWithTitle:@"Multivalued examples"];        // 初始化每个cell的类型与属性    section = [XLFormSectionDescriptorformSectionWithTitle:@"MultiValued TextField"                                             sectionOptions:XLFormSectionOptionCanReorder | XLFormSectionOptionCanInsert |XLFormSectionOptionCanDelete];    section.multivaluedTag =@"textFieldRow";    [form addFormSection:section];    //添加循环遍历数组动态添加数据 思考可以将数组做成plist文件，这样可以单独配置有需求可以修改    for (NSString * tagin nameList) {//        创建一个单行输入框        row = [XLFormRowDescriptorformRowDescriptorWithTag:nilrowType:XLFormRowDescriptorTypeTexttitle:nil];        //设置placeholder        [[row cellConfig]setObject:@"Add a new tag"forKey:@"textField.placeholder"];        //添加默认值        row.value = [tagcopy];        //添加到一组中        [section addFormRow:row];    }//     最后添加看一个添加按钮    row = [XLFormRowDescriptorformRowDescriptorWithTag:nilrowType:XLFormRowDescriptorTypeTexttitle:nil];    [[row cellConfig]setObject:@"Add  tag"forKey:@"textField.placeholder"];    [section addFormRow:row];        return [superinitWithForm:form];}

• 获取值

你能在-(NSDictionary *)formValues中获取所有的行信息，或者是XLFormViewController实例和XLFormDescriptor实例

XLForm添加值添加在行信息XLFormRowDescriptor中，它属于XLFormSectionDescriptor，用建立XLFormRowDescriptor时传入的Tag还获取值，其中并不存multivaluedTag。

每一个组信息中都存在着一个multivaluedTag值，里面存在着当前组内的行信息的数组multivaluedTag值为Key

例如：

    //根据 section.multivaluedTag = @"textFieldRow" 获取到相应的组信息，打印出来的为当前组的所有行的value    NSArray * tempvalues =form.formValues[@"textFieldRow"];    NSLog(@"%@",form.formValues[@"textFieldRow"]);    //formSections中存储着表单中所有组的指针    XLFormSectionDescriptor * tempsection=form.formSections[0];    //重新遍历一次，值是一样的    for (int index=0; index<tempvalues.count; index++) {          XLFormRowDescriptor * row =  tempsection.formRows[index];        NSLog(@"%@--%@",tempvalues[index],row.value);    }

综合案例：

    XLFormDescriptor * form;//建立表单，等同于创建uitableview    XLFormSectionDescriptor * section;//建立组  section    XLFormRowDescriptor * row;//建立行相当于cell    //设置标题    form = [XLFormDescriptor formDescriptorWithTitle:@"Add Event"];    section = [XLFormSectionDescriptor formSection];    [form addFormSection:section];        // Title  设置textField    row = [XLFormRowDescriptor formRowDescriptorWithTag:@"Title" rowType:XLFormRowDescriptorTypeText];    //设置placeholder    [row.cellConfigAtConfigure setObject:@"Title" forKey:@"textField.placeholder"];    row.required = YES;    [section addFormRow:row];        // Location    row = [XLFormRowDescriptor formRowDescriptorWithTag:@"location" rowType:XLFormRowDescriptorTypeText];    [row.cellConfigAtConfigure setObject:@"Location" forKey:@"textField.placeholder"];    [section addFormRow:row];        section = [XLFormSectionDescriptor formSection];    [form addFormSection:section];        // All-day    row = [XLFormRowDescriptor formRowDescriptorWithTag:@"all-day" rowType:XLFormRowDescriptorTypeBooleanSwitch title:@"All-day"];    [section addFormRow:row];        // Starts    row = [XLFormRowDescriptor formRowDescriptorWithTag:@"starts" rowType:XLFormRowDescriptorTypeDateTimeInline title:@"Starts"];    row.value = [NSDate dateWithTimeIntervalSinceNow:60*60*24];    [section addFormRow:row];        // Ends    row = [XLFormRowDescriptor formRowDescriptorWithTag:@"ends" rowType:XLFormRowDescriptorTypeDateTimeInline title:@"Ends"];    row.value = [NSDate dateWithTimeIntervalSinceNow:60*60*25];    [section addFormRow:row];    section = [XLFormSectionDescriptor formSection];    [form addFormSection:section];    // Repeat    row = [XLFormRowDescriptor formRowDescriptorWithTag:@"repeat" rowType:XLFormRowDescriptorTypeSelectorPush title:@"Repeat"];    row.value = [XLFormOptionsObject formOptionsObjectWithValue:@(0) displayText:@"Never"];    row.selectorTitle = @"Repeat";    row.selectorOptions = @[[XLFormOptionsObject formOptionsObjectWithValue:@(0) displayText:@"Never"],                            [XLFormOptionsObject formOptionsObjectWithValue:@(1) displayText:@"Every Day"],                            [XLFormOptionsObject formOptionsObjectWithValue:@(2) displayText:@"Every Week"],                            [XLFormOptionsObject formOptionsObjectWithValue:@(3) displayText:@"Every 2 Weeks"],                            [XLFormOptionsObject formOptionsObjectWithValue:@(4) displayText:@"Every Month"],                            [XLFormOptionsObject formOptionsObjectWithValue:@(5) displayText:@"Every Year"],                            ];    [section addFormRow:row];    section = [XLFormSectionDescriptor formSection];    [form addFormSection:section];        // Alert    row = [XLFormRowDescriptor formRowDescriptorWithTag:@"alert" rowType:XLFormRowDescriptorTypeSelectorPush title:@"Alert"];    row.value = [XLFormOptionsObject formOptionsObjectWithValue:@(0) displayText:@"None"];    row.selectorTitle = @"Event Alert";    row.selectorOptions = @[[XLFormOptionsObject formOptionsObjectWithValue:@(0) displayText:@"None"],                            [XLFormOptionsObject formOptionsObjectWithValue:@(1) displayText:@"At time of event"],                            [XLFormOptionsObject formOptionsObjectWithValue:@(2) displayText:@"5 minutes before"],                            [XLFormOptionsObject formOptionsObjectWithValue:@(3) displayText:@"15 minutes before"],                            [XLFormOptionsObject formOptionsObjectWithValue:@(4) displayText:@"30 minutes before"],                            [XLFormOptionsObject formOptionsObjectWithValue:@(5) displayText:@"1 hour before"],                            [XLFormOptionsObject formOptionsObjectWithValue:@(6) displayText:@"2 hours before"],                            [XLFormOptionsObject formOptionsObjectWithValue:@(7) displayText:@"1 day before"],                            [XLFormOptionsObject formOptionsObjectWithValue:@(8) displayText:@"2 days before"],                            ];    [section addFormRow:row];    section = [XLFormSectionDescriptor formSection];    [form addFormSection:section];        // Show As    row = [XLFormRowDescriptor formRowDescriptorWithTag:@"showAs" rowType:XLFormRowDescriptorTypeSelectorPush title:@"Show As"];    row.value = [XLFormOptionsObject formOptionsObjectWithValue:@(0) displayText:@"Busy"];    row.selectorTitle = @"Show As";    row.selectorOptions = @[[XLFormOptionsObject formOptionsObjectWithValue:@(0) displayText:@"Busy"],                            [XLFormOptionsObject formOptionsObjectWithValue:@(1) displayText:@"Free"]];    [section addFormRow:row];    section = [XLFormSectionDescriptor formSection];    [form addFormSection:section];    // URL    row = [XLFormRowDescriptor formRowDescriptorWithTag:@"url" rowType:XLFormRowDescriptorTypeURL];    [row.cellConfigAtConfigure setObject:@"URL" forKey:@"textField.placeholder"];    [section addFormRow:row];        // Notes    row = [XLFormRowDescriptor formRowDescriptorWithTag:@"notes" rowType:XLFormRowDescriptorTypeTextView];    [row.cellConfigAtConfigure setObject:@"Notes" forKey:@"textView.placeholder"];    [section addFormRow:row];            self.form = form;

文字改变监听：

#pragma mark - 文字修改代理-(void)formRowDescriptorValueHasChanged:(XLFormRowDescriptor *)rowDescriptor oldValue:(id)oldValue newValue:(id)newValue{    NSLog(@"rowDescriptor.tag :%@",rowDescriptor.tag);    NSLog(@"rowDescriptor.value:%@",rowDescriptor.value);    NSLog(@"oldValue:%@",oldValue);    NSLog(@"newValue:%@",newValue);        [super formRowDescriptorValueHasChanged:rowDescriptor oldValue:oldValue newValue:newValue];    if ([rowDescriptor.tag isEqualToString:@"alert"]){        if ([[rowDescriptor.value valueData] isEqualToNumber:@(0)] == NO && [[oldValue valueData] isEqualToNumber:@(0)]){//            动态添加            XLFormRowDescriptor * newRow = [rowDescriptor copy];            newRow.tag = @"secondAlert";            newRow.title = @"Second Alert";            [self.form addFormRow:newRow afterRow:rowDescriptor];        }        else if ([[oldValue valueData] isEqualToNumber:@(0)] == NO && [[newValue valueData] isEqualToNumber:@(0)]){            [self.form removeFormRowWithTag:@"secondAlert"];        }    }    else if ([rowDescriptor.tag isEqualToString:@"all-day"]){        XLFormRowDescriptor * startDateDescriptor = [self.form formRowWithTag:@"starts"];        XLFormRowDescriptor * endDateDescriptor = [self.form formRowWithTag:@"ends"];        XLFormDateCell * dateStartCell = (XLFormDateCell *)[[self.form formRowWithTag:@"starts"] cellForFormController:self];        XLFormDateCell * dateEndCell = (XLFormDateCell *)[[self.form formRowWithTag:@"ends"] cellForFormController:self];        if ([[rowDescriptor.value valueData] boolValue] == YES){            startDateDescriptor.valueTransformer = [DateValueTrasformer class];            endDateDescriptor.valueTransformer = [DateValueTrasformer class];            [dateStartCell setFormDatePickerMode:XLFormDateDatePickerModeDate];            [dateEndCell setFormDatePickerMode:XLFormDateDatePickerModeDate];        }        else{            startDateDescriptor.valueTransformer = [DateTimeValueTrasformer class];            endDateDescriptor.valueTransformer = [DateTimeValueTrasformer class];            [dateStartCell setFormDatePickerMode:XLFormDateDatePickerModeDateTime];            [dateEndCell setFormDatePickerMode:XLFormDateDatePickerModeDateTime];        }        [self updateFormRow:startDateDescriptor];        [self updateFormRow:endDateDescriptor];    }    else if ([rowDescriptor.tag isEqualToString:@"starts"]){        XLFormRowDescriptor * startDateDescriptor = [self.form formRowWithTag:@"starts"];        XLFormRowDescriptor * endDateDescriptor = [self.form formRowWithTag:@"ends"];        if ([startDateDescriptor.value compare:endDateDescriptor.value] == NSOrderedDescending) {            // startDateDescriptor is later than endDateDescriptor            endDateDescriptor.value =  [[NSDate alloc] initWithTimeInterval:(60*60*24) sinceDate:startDateDescriptor.value];            [endDateDescriptor.cellConfig removeObjectForKey:@"detailTextLabel.attributedText"];            [self updateFormRow:endDateDescriptor];        }    }    else if ([rowDescriptor.tag isEqualToString:@"ends"]){        XLFormRowDescriptor * startDateDescriptor = [self.form formRowWithTag:@"starts"];        XLFormRowDescriptor * endDateDescriptor = [self.form formRowWithTag:@"ends"];        XLFormDateCell * dateEndCell = (XLFormDateCell *)[endDateDescriptor cellForFormController:self];        if ([startDateDescriptor.value compare:endDateDescriptor.value] == NSOrderedDescending) {            // startDateDescriptor is later than endDateDescriptor            [dateEndCell update]; // force detailTextLabel update            NSDictionary *strikeThroughAttribute = [NSDictionary dictionaryWithObject:@1                                                                               forKey:NSStrikethroughStyleAttributeName];            NSAttributedString* strikeThroughText = [[NSAttributedString alloc] initWithString:dateEndCell.detailTextLabel.text attributes:strikeThroughAttribute];            [endDateDescriptor.cellConfig setObject:strikeThroughText forKey:@"detailTextLabel.attributedText"];            [self updateFormRow:endDateDescriptor];        }        else{            [endDateDescriptor.cellConfig removeObjectForKey:@"detailTextLabel.attributedText"];            [self updateFormRow:endDateDescriptor];        }    }}