React多层级表单

---------------------- 此方案已弃用 ----------------------

弃用原因：

渲染[大型表单]时会卡顿。增加表单项过多会卡顿。小型表单可以使用。

此方案当时设计时，增加及删除表单项是强制整个表单重新渲染，考虑欠佳。

项目中已使用 rc-field-form 重新封装。

rc-field-form 采用增量更新方式，性能比 rc-form 提升很多，提供了 List 组件自带增加删除表单项，仍要考虑避免不必要的更新。

ant-design 目前表单用的是 rc-form，V4 版本换成了 rc-field-form。

参考 antd 源码和 rc-field-form。

 Ant-design 4.x  Form 中已提供 Form.List ，可实现简单的动态增减表单。

-----------------------------------------------------------

 

因项目需要封装的组件，组件库使用的是Ant Design

📙 项目地址 :

     👉 Github地址(React Multi-level Form)：https://github.com/zlinggnilz/react-multi-level-form 

     👉 在线示例：https://codesandbox.io/s/clever-montalcini-litjo

📋 说明 :

用到了 Form组件 , 布局组件，表单控件 ，如果没有使用Ant Design，可以用rc-form代替，需要对组件中使用的表单控件和布局进行替换。

example示例待完善，参数可参考组件中的proptypes 

 

🛎️ 注意 :

如果表单很大比较复杂，目前的使用方式，因为是onChange的时候触发表单收集数据，导致频繁render，导致填写表单时候会有些卡。

解决方式 :  此组件中未做处理，根据需要自行处理。我在项目中目前使用的方式是，对input, textarea, inputNumber 输入类型的控件做onBlur的时候触发表单数据收集。其他控件和自定义控件还是由onChange触发。小的表单可以不用考虑，还用onChange的方式。

 

📖 使用 :

需要formAttr表述层级结构，data为表单原始值，默认为 { }，表单最终提交的是对应层级结构的Object，如：

formAttr:

const formAttr = [
  {
    label: '游乐园',
    key: 'park',
    multi: true,
    children: [
      { label: '名称', key: 'name' },
      { label: '地点', key: 'location', required: false },
      { label: '评分', key: 'rate', type: 'int', required: false }
    ]
  }
];

js:

<MultiForm formAttr={formAttr} data={{}} onSubmit={this.handleSubmit} loading={loading} />

页面显示:

Submit Data:

{
  "park": [
    {
      "name": "名称1",
      "location": "地址1",
      "rate": 4
    },
    {
      "name": "名称2",
      "location": "地点2",
      "rate": 5
    }
  ]
}

 

📚 参考 :

• Ant-design官网的示例：动态增减表单项 https://ant.design/components/form-cn/#components-form-demo-dynamic-form-item
• rc-form http://react-component.github.io/form/