Ant Design 组件 —— Form表单（二）-广州芦苇科技

Ant Design of React @3.10.9

拉取项目 luwei.web.study-ant-design-pro, 切换至 add 分支，可看到 Form 表单实现效果

实现一个新增表单

新增表单

思路

Create表单：@Form.create()
表单数据绑定 getFieldDecorator
渲染查询表单的查询条件 render <Form.Item>
定义表单校验条件 rules
设置一组输入控件的值 setFieldsValue
获取查询条件的值 validateFields

区别于Form表单(一)，新增了 表单校验条件 和 设置控件值 两点。

代码

1. Create表单：`@Form.create()`

Form.create()

这是一个高阶函数，传入的是react组件，返回一个新的react组件，在函数内部会对传入组件进行改造，添加上一定的方法用于进行一些秘密操作如果有对高阶组件有想要深入的请移步《深入理解 React 高阶组件》，我们这里不做过多的深究。

经 Form.create() 包装过的组件会自带 this.props.form 属性

// 使用方式如下：
class CustomizedForm extends React.Component {}
CustomizedForm = Form.create({})(CustomizedForm);

代码中结合 @ 的修饰器，用 @Form.create() 进行创建。

2. 表单数据绑定 `getFieldDecorator`

getFieldDecorator(id, options)

用于和表单进行双向绑定

<!-- 表单数据绑定 -->
<Form.Item {...formItemLayout} label={'名称'}>
    {getFieldDecorator('searchName')(
        <Input placeholder={'请输入名称'} />
    )}
</Form.Item>

3. 渲染查询表单的查询条件 `render <Form.Item>`

在定义表单字段的时候，渲染到页面中，与步骤2代码一致

更多FormItem属性请参考Ant Design - Form - Form.Item

4. 定义表单校验条件 rules

<Form.Item {...formItemLayout} label="名称">
    {getFieldDecorator('name', {
        rules: [
          {
              required: true,
              message: '必填',
          },
        ],
        initialValue: this.state.name,
})(<Input placeholder="请输入名称" maxLength={25} />)}

校验规则请参考Ant Design - Form 校验规则

5. 设置一组输入控件的值 setFieldsValue

this.props.form.setFieldsValue({
  name: `hello world`,
});

使用场景：

新增信息，将每个字段置空

更新信息，将原有的数据设置在相对的表单控件中。

setFieldsValue

动态设置/控制表单中控件的值

注意

使用 getFieldsValue getFieldValue setFieldsValue 等时，应确保对应的 field 已经用 getFieldDecorator 注册过了。

设置一组输入控件的值（注意：不要在 componentWillReceiveProps 内使用，否则会导致死循环

6. 获取查询条件的值 `validateFields`

form.validateFields / validateFieldsAndScroll

校验并获取一组输入域的值与 Error，若 fieldNames 参数为空，则校验全部组件

const { form } = this.props;

// 获取并检查表单数据
form.validateFields((err, fieldsValue) => {
      if (err) return;
      const { searchName = '' } = fieldsValue;
});

深入了解

芦苇科技前端开发工程师

芦苇科技-广州专业软件外包服务公司

提供微信小程序、APP应用研发、UI设计等专业服务，专注于互联网产品咨询、品牌设计、技术研发等领域

访问 www.talkmoney.cn 了解更多

万能说明书 | 早起日记Lite | 凹凸壁纸 | 言财

Ant Design 组件 —— Form表单（二）