v-decorator在from表单中的使用

v-decorator看起来是一个vue指令， 他并不是vue本身的指令，它是通过ant-design-vue去获取表单数据时使用v-decorator方式去给每个项注册，这样才能通过组件去拉取表单的数据，同时对必填项做校验；

创建表单

<template>
  <a-form @submit="handleOk" :form="form">
    // :form="form" 必须优先注册
    <!-- 客户姓名 -->
    <a-form-item
        :labelCol="labelCol" // 排列样式
        :wrapperCol="wrapperCol"
        label='客户姓名：'
      >
      <a-input
        v-decorator="[
          'name', // 给表单赋值或拉取表单时，该input对应的key
          {rules: [{ required: true, message: '请输入客户名称!' }]}
        ]"
        placeholder="请输入客户名称"/>
    </a-form-item>
  </a-form>
</template>

export default {
  data() {
    return {
      form: this.$form.createForm(this), // 只有这样注册后，才能通过表单拉取数据
    }
  }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

拉取表单数据的方法

• 通过validateFields的方法，能够校验必填项是否有值，若无，则页面会给出警告！

this.form.validateFields((err, values) => {
  if (err) {
    // 这里做逻辑处理
    console.log(values) // { name: '' }
  }
}
1
2
3
4
5
6

清空表单的方法

• 执行this.form.resetFields()，则会将表单清空。

给表单赋值

• setFieldsValue只有通过这种方式给表单赋值，拉取表单的时候才能拉取到值，其他设置默认值的方式，拉取表单时都无法获取到默认值。

this.form.setFieldsValue({
   name: '设置值' //这里的name对应着v-decorator中的name
 })
1
2
3

给表单中添加自定义校验

<a-form-item
  v-bind="formItemLayout"
  label="E-mail"
>
  <a-input
    v-decorator="[
      'email',
      {
        rules: [{
          type: 'email', message: 'The input is not valid E-mail!',
        }, {
          required: true, message: 'Please input your E-mail!',
        }]
      }
    ]"
  />
</a-form-item>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

失去焦点再做校验

<a-form-item
  :labelCol="labelCol"
  :wrapperCol="wrapperCol"
  label='手机：'
>
<a-input
  type="number"
  v-decorator="[
    'phone',
    {
      rules: [
        { required: false, message: '请输入手机号码!' },]
    },
  ]"
  @blur="validatePhoneBlur"
  placeholder='请输入手机号码' />
</a-form-item>

// 校验事件
validatePhoneBlur(e) {
  const validatePhoneReg = /^1\d{10}$/
  if (e.target.value && !validatePhoneReg.test(e.target.value)) {
    const arr = [{
      message: '您输入的手机格式不正确!',
      field: 'phone',
    }]
    this.form.setFields({ phone: { value: e.target.value, errors: arr } })
  }
},
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29