前言: 都2020年了 之前接触过有两个项目,那种详情页面,表单编辑页面,还在用scrollerView 然后一个个label加 ，整个页面又臃肿又长,想要改点什么都特别麻烦 布局都会乱,心中真是改的在滴血。

控件 WMZForm 一个简单使用的表单应运而生

还是先看看效果吧

实现页面	图片
单纯表单页面(可各种配置调样式)	单纯表单.gif
实现的一个简单朋友圈	朋友圈.gif
简单实现一些设置的界面	设置.gif
所有属性的页面-比较多比较杂乱	所有属性.gif

简单一句话概括这个控件 - 表单~不止于表单

特效

• 支持可自定义cell,cell需要继承于baseCell
• 支持实现目前大多数表单的功能
• 支持自定义选择弹窗的内容
• 性能优化,高度缓存
• 可链式可属性轻松调用
• 可自定义cell上的ui控件

目前自带的样式介绍

• FormCellDefault ~ 默认样式
• FormCellNormal ~ 左右文本
• FormCellIcon ~ 带图片+文本
• FormCellInput ~ 单行输入框
• FormCellText ~ 只有一个文本
• FormCellTextView ~ 多行输入
• FormCellVerification ~ 验证码输入
• FormCellImage ~ 九宫格选择/显示图片
• FormCellSwitch ~ 开关
• FormCellCheck ~ 选择
• FormCellTag ~ 标签
• FormCellCommit ~ 按钮
• FormCellEdit ~ 编辑
• FormCellTakePicture~ 添加图片

用法介绍

初始化添加数据 - 属性有点多这里没法一次性说清 详情可以看demo 或者来问我

//初始化
WMZForm *form =
Form(CGRectMake(0, NavigationBar_Form_Height, self.view.bounds.size.width , self.view.bounds.size.height - NavigationBar_Form_Height))

//直接不带section 用row直接添加
.wAddFormRow(^(WMZFormRowModel * _Nullable rowModel) {
    rowModel
    .wFormValue(@"AllPropertiesVC")
    .wFormName(@"全部属性demo")
    .wFormCellAccessoryType(UITableViewCellAccessoryDisclosureIndicator)
    .wFormShowLine(YES);
});

//直接section添加 WMZFormRowModel为子集
.wAddFormSection(^(WMZFormSectionModel * _Nullable sectionModel) {
      //子集
      WMZFormRowModel *rowModel =
      FormRowModel()
      //tableviewCell的类名 自定义的时候传@"customCellName"你创建的cell的类名即可
      .wFormCellName(@(FormCellCommit))
      .wFormRowData(@{@"fill":@(YES),@"type":@(FormClickClick)})
       //自定义button
      .wFormCustomButton(^(UIButton * _Nullable button) {
          button.backgroundColor = [UIColor whiteColor];
          [button setTitleColor:[UIColor redColor] forState:UIControlStateNormal];
      })
      .wFormBtn(@"退出");
    
      sectionModel
      .wFormHeadHeight(20)
      .wFormFootHeight(20)
       //添加section的数据 rowModel组成的数据
      .wFormSectionData(@[rowModel])
      .wFormCellName(@(FormCellTag));
});

代理方法

/*
 *formCell点击
 @param cell  所在的cell (cell.model为model cell.indexPath 为其所在的indexPath)
 */
- (void)form:(WMZForm*)form didSelectRowAtCell:(WMZFormBaseCell*)cell;

/*
 *form提交
 @param commitInfo  提交的信息 为一个带value和key的字典
 @param success  是否通过检验规则可以提交
 */
- (void)form:(WMZForm*)form info:(NSDictionary*)commitInfo canCommit:(BOOL)success;

/*
 *formCell上的view点击 用于cell上的控件的交互事件
 @param clickView  点击的view
 @param cell  所在的cell
 @param action  根据action判断交互的事件
 */
- (void)form:(WMZForm*)form
        subViewDidSelectRowAtCell:(WMZFormBaseCell*)cell
        view:(UIView*)clickView
        type:(id)action;

数据更新删除等 提供了多个实例方法

 //addRow 非初始化增加row调用 默认插入最后
- (BOOL)wAddFormRow:(WMZFormRowModel*)rowModel;
//addRow 非初始化增加row调用 插入index的位置 传入-1不刷新
- (BOOL)wAddFormRow:(WMZFormRowModel*)rowModel atIndex:(NSInteger)index;
//addRow 非初始化增加row调用 插入index的位置 传入-1不刷新
- (BOOL)wAddFormRowBlock:(FormRowBlock)addFormRow atIndex:(NSInteger)index;
//addSection 非初始化增加section调用 默认插入最后
- (BOOL)wAddFormSection:(WMZFormSectionModel*)sectionModel;
//addSection 非初始化增加section调用 插入index的位置 传入-1不刷新
- (BOOL)wAddFormSection:(WMZFormSectionModel*)sectionModel atIndex:(NSInteger)index;
//addSection 非初始化增加section调用 插入index的位置 传入-1不刷新
- (BOOL)wAddFormSectionBlock:(FormSectionBlock)addFormSection atIndex:(NSInteger)index;
//deleleSectionWithKey
- (BOOL)wDeleteFormSectionWithKey:(NSString*)key;
//deleleSectionWithKey
- (BOOL)wDeleteFormSectionWithIndex:(NSInteger)index;
//deleleRowWithKey
- (BOOL)wDeleteFormRowWithKey:(NSString*)key;
//deleleRowWithIndexPath
- (BOOL)wDeleteFormRowWithIndexPath:(NSIndexPath*)indexPath;
//reloadRow With key
- (BOOL)wReloadRowWithKey:(NSString*)key;
//reloadRow With indexPath
- (BOOL)wReloadRowWithIndexPath:(NSIndexPath*)indexPath;
//reloadSection With key
- (BOOL)wReloadSectionWithKey:(NSString*)key;
//reloadSection With index
- (BOOL)wReloadSectionWithIndex:(NSInteger)index;
//getRow With key
- (WMZFormRowModel*)wFindRowModelWithKey:(NSString*)key;
//getRow With indexPath
- (WMZFormRowModel*)wFindRowModelWithIndexPath:(NSIndexPath*)indexPath;
//getSection With key
- (WMZFormSectionModel*)wFindSectionModelWithKey:(NSString*)key;
//getSection With index
- (WMZFormSectionModel*)wFindSectionModelWithIndex:(NSInteger)index;
//reloadData
- (void)wReloadData;
//自定义刷新
- (void)wReloadData:(FormCustomReload)block;

安装

CocoaPods

1. 将 cocoapods 更新至最新版本.
2. 在 Podfile 中添加 pod 'WMZForm'。
3. 执行 pod install 或 pod update。
4. 导入 #import "WMZForm.h"。

注:要消除链式编程的警告

要在Buildding Settings 把CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF 设为NO

手动安装

1. 下载 WMZForm 文件夹内的所有内容。
2. 将 WMZForm 内的源文件和依赖的库添加(拖放)到你的工程。
3. 导入 #import "WMZForm.h"

依赖

1WMZDialog（弹窗控件）
2 Masonry
3 SDWebImage
4 IQKeyboardManager

使用过程中如果有什么bug欢迎给我提issue 我看到就会解决
觉得有用的话给个star

WMZForm