Ant Design Vue

Ant Design Vue是 Ant Design 3.X 的 Vue 实现,开发和服务于企业级后台产品。在GitHub上可以找到几个Ant Design的Vue组件。不过相比较而言,Ant Design Vue更胜一筹。Ant Design Vue共享Ant Design of React设计工具体系,实现了所有Ant Design of React的组件,支持现代浏览器和 IE9 及以上(需要 polyfills)。可以让熟悉Ant Design的在使用Vue时,很容易的上手。

自定义校验

先给一张Ant Design Vue得form表单中不同类型的校验场景图,看看是否有你需要的:

antdesign vue form 验证多层数据 ant design vue form如何赋值_Ant Design Vue自定义校验


官方提供了 validateStatus, help ,hasFeedback 等属性,你可以不需要使用 Form.creategetFieldDecorator,自己定义校验的时机和内容。

  • validateStatus: 校验状态,可选 ‘success’, ‘warning’, ‘error’, ‘validating’。
  • hasFeedback:用于给输入框添加反馈图标。
  • help:设置校验文案。

说明一点: 当你使用Ant Design Vue的使用,经过 Form.create 包装的组件将会自带 this.form 属性
this.form 提供的 关于校验的API如下 :

方法

说明

类型

validateFields

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

Function([fieldNames: string[]], [options: object], callback: Function(errors, values))

然后看下Form.Item的参数设置(主要看关于校验的):

参数

说明

类型

默认值

extra

额外的提示信息,和 help 类似,当需要错误信息和提示文案同时出现时,可以使用这个。

string/slot

hasFeedback

配合 validateStatus 属性使用,展示校验状态图标,建议只配合 Input 组件使用。

boolean

false

help

提示信息,如不设置,则会根据校验规则自动生成

string/slot

validateStatus

校验状态,如不设置,则会根据校验规则自动生成,可选:‘success’ ‘warning’ ‘error’ ‘validating’

string

最后是校验规则设置:

antdesign vue form 验证多层数据 ant design vue form如何赋值_Ant Design Vue表单使用_02


相关的api及参数设置介绍完乐,下面上实例

实例

写一个简单的例子

form表单代码:

<a-form style="max-width: 500px; margin: 40px auto 0;" @submit="handleSubmit" :form="form">
        <a-form-item
                label="密码"
                :labelCol="{span: 5}"
                :wrapperCol="{span: 19}"
                class="stepFormText"
                hasFeedback
        >
          <a-input
                  v-decorator="[
                  'password',
                  {rules: [{ required: true, message: '请输入密码' },{validator: handlePass}]}
                ]"
                  name="password"
          />
        </a-form-item>
        <a-form-item
                label="确认密码"
                :labelCol="{span: 5}"
                :wrapperCol="{span: 19}"
                class="stepFormText"
                hasFeedback
        >
          <a-input
                  v-decorator="[
                  'confirm_password',
                  {rules: [{ required: true, message: '请输入确认密码' },{validator: handleConfirmPass}]}
                ]"
                  name="confirm_password"
          />
        </a-form-item>
        <a-form-item :wrapperCol="{span: 19, offset: 5}">
          <a-button :loading="loading" type="primary"  htmlType="submit">提交</a-button>
        </a-form-item>
      </a-form>

进行一下说明,以确认密码的校验为例:

<a-input
                  v-decorator="[
                  'confirm_password',
                  {rules: [{ required: true, message: '请输入确认密码' },{validator: handleConfirmPass}]}
                ]"
                  name="confirm_password"
          />

rules中为一个数组,每一项就是一个校验规则,第一项规则容易理解,但是{validator: handleConfirmPass}是什么的,我们通过上面的校验规则设置(红框处)可以发现,这是当你设置自定义校验的时候需要这么写。注意:callback 必须被调用
handleConfirmPass 其实就是自定义校验的校验方法。
js代码:

<script>
export default {
    data () {
        return {
            labelCol: {
                xs: { span: 24 },
                sm: { span: 7 }
            },
            wrapperCol: {
                xs: { span: 24 },
                sm: { span: 13 }
            },
            password: '',
            // form
            form: this.$form.createForm(this)
        }
    },
    methods: {
        handlePass(rule,value,callback){
            this.password = value
            callback()
        },
        handleConfirmPass(rule,value, callback){
            if (this.password && this.password !== value) {
                callback('两次密码输入不一致!')
            }
            // Note: 必须总是返回一个 callback,否则 validateFieldsAndScroll 无法响应
            callback()
        },
        handleSubmit (e) {
            e.preventDefault()
            this.form.validateFields((err, values) => {
                if (!err) {
                	console.log(values)
                }
            })

        }
    }
}
</script>

效果图如下:

1.空值提交

antdesign vue form 验证多层数据 ant design vue form如何赋值_v-decorator的使用_03


2.自定义校验规则生效

antdesign vue form 验证多层数据 ant design vue form如何赋值_Vue_04


好了,这就是关于Ant Design Vue的普通及自定义校验的简单使用。