ElementUI中el-form组件的rules参数举例详解

 更新时间:2023年10月24日 10:35:32   作者:JAVA海洋里的小鱼  
Form组件提供了表单验证的功能,只需要通过rules属性传入约定的验证规则,并将Form-Item的prop属性设置为需校验的字段名即可,下面这篇文章主要给大家介绍了关于ElementUI中el-form组件的rules参数的相关资料,需要的朋友可以参考下

在检验规则的代码中,我们可以看到规则对象中包含required/message/trigger/min/max等参数,这些参数配合起来,可以完成我们以往要编写多行代码才能实现的校验功能。

下面就详细介绍

参数说明

属性

类型

说明

type

String

用于验证数据类型,默认类型为’string’

required

boolean

是否必填

pattern

regexp/string

字段值匹配正则表达式才能通过验证

min和max

number

对于字符串和数组类型,将根据长度进行比较,对于数字类型,数字不得小于min,也不得大于max

len

number

对于字符串和数组类型,对length属性执行比较,对于数字类型,此属性指示数字的完全匹配,len属性与min和max属性组合,则len优先。

enum

array

type必须设置为enum,值必须包含在从可能值列表中才能通过验证

trigger

blur/change

触发验证的时机,blur失去焦点时触发,change:值发生改变时触发

whitespace

boolean

type必须设置为string,要为仅包含空格的字符串可以whitespace设置为true

transform

function

在验证之前转换值

defaultField

array/object

type为数组或对象类型时一起使用,用来验证数组或对象中包含的所有值,进行深层验证

fields

object

type为数组或对象类型时一起使用,分别验证array/object类型的数据中的值,实现深度验证

validator

function

验证器,可以为指定字段自定义验证函数:function(rule, value, callback)

asyncValidator

function

异步验证器,可以为指定字段自定义异步验证函数 function(rule, value, callback)

message

string/jsx/function等

根据需要将消息分配给规则

下面详细介绍参数属性说明

type

表明要使用验证器的类型,类似数据格式检验,其中还有email、url、regexp、method等特定格式字段的验证。

使用这个,我们就可以对一些特定的字段进行校验,而不用再像以前一样写正则,做判断。

比如只需要配置 type:‘email’ 的规则就可以验证email了,验证器都已经封装好了这些功能,你只需调用就可以了。

可识别的类型值有:

string

字符串类型(默认值)

number

数字类型

boolean

布尔类型

method

函数类型

regexp

正则表达式

integer

整型

float

双精度浮点型数字

array

数组类型

object

对象类型

enum

枚举值

date

日期格式

url

网址格式

hex

16进制数字

email

电子邮箱格式

any

任意类型

//验证电子邮箱的完整示例代码
email = [{
    type: "string",
    required: true,
    message: '请输入邮箱地址',
    trigger: 'blur'
  },
  {
    type: 'email',
    message: '请输入正确的邮箱地址',
    trigger: ['blur', 'change']
  }
]

如上,实现了文本框失去焦点进行非空检验,失去焦点、内容改变进行格式验证,并给出相应提示.

required

必填字段,即非空验证。如上面实例中的的非空验证,以及邮箱前边的必填符号*,就是这个参数的功劳。

pattern

正则表达式,如果需要验证手机号码之类,可以直接编写正则表达式配置到校验规则中,那么就不需要自己去校验了,由校验器自动校验。

{ type : "string" , required: true , pattern : /^[a-z]+$/ }

min/max

判断数据大小范围,通常对数字大小范围做校验。对于字符串和数组类型,将根据长度进行比较。

{ required: true, message: '请输入活动名称', trigger: 'blur' },
{ min: 3, max: 5, message: '长度在 3 到 5 个字符', trigger: 'blur' }

len

长度验证,如11位手机号码。

roles: {
    type: "array", required: true, len: 11
}

trigger

取值为blur/change, blur失去焦点时触发,change:值发生改变时触发

enum

枚举值验证,示例代码如下:

role: {type: "enum", enum: ['admin', 'user', 'guest']}

whitespace

验证是否只有空格(如果没有该配置,则全空格的输入值也是有效的)。

whitespace: [{
    type: "string",
    message: '只存在空格',
    whitespace:true,
    trigger: ['change', 'blur']
}]

transform

有时有必要在验证之前转换值,以强制或以某种方式对其进行清理。为此 transform ,向验证规则添加一个功能。在验证之前,先转换属性,然后将其重新分配给源对象,以更改该属性的值。

transform: [
 {
    type: 'enum',
    enum: [2,4,6], 
    message: `结果不存在`, 
    trigger: ['change', 'blur'],
    transform(value) {
      return Number(value * 2)
    }
  }
]

如上,只有输入1、2、3的时候才能校验通过,这个只能辅助校验,并不能改变组件绑定变量本身的值。

fields

深层规则,可以通过将嵌套规则分配给规则的属性来验证object或array类型的验证规则,如地址对象的省市区的规则验证:

object类型:
address: {
    type: "object", required: true,
    fields: {
      street: {type: "string", required: true},
      city: {type: "string", required: true},
      zip: {type: "string", required: true, len: 8, message: "invalid zip"}
    }
  }
array类型:
 roles: {
    type: "array", required: true, len: 3,
    fields: {
      0: {type: "string", required: true},
      1: {type: "string", required: true},
      2: {type: "string", required: true}
    }
  }

messages

未通过校验的提示信息:

{name:{type: "string", required: true, message: "Name is required"}}

支持html:

{name:{type: "string", required: true, message: "<b>Name is required</b>"}}

支持vue-i18n:

{name:{type: "string", required: true, message: () => this.$t( 'name is required' )}}

validator

可以为指定字段自定义验证函数——这就相当于把前边配置的东西用js按照以前的方式编写验证逻辑了。虽然麻烦点,但是能实现比较复杂的业务逻辑判断。

例如:判断密码是否为空

data(){
       var checkPass= (rules,value,callback) =>{
            if(value ==''){
                callback(new Error('请输入密码'));
            }else{
                callback();
            }
        }
        return{
            rules:{
                pass:[vaildatot:checkPass,trigger:blur]
            }
        }
}

总结 

到此这篇关于ElementUI中el-form组件的rules参数举例详解的文章就介绍到这了,更多相关ElementUI el-form组件rules参数内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • vue输入框使用模糊搜索功能的实现代码

    vue输入框使用模糊搜索功能的实现代码

    这篇文章主要介绍了vue输入框使用模糊搜索功能,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-05-05
  • Vue中的@blur事件 当元素失去焦点时所触发的事件问题

    Vue中的@blur事件 当元素失去焦点时所触发的事件问题

    这篇文章主要介绍了Vue中的@blur事件 当元素失去焦点时所触发的事件问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-08-08
  • vue如何实现关闭对话框后刷新列表

    vue如何实现关闭对话框后刷新列表

    这篇文章主要介绍了vue如何实现关闭对话框后刷新列表,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-04-04
  • 关于vue中使用three.js报错的解决方法

    关于vue中使用three.js报错的解决方法

    最近因为three.js的项目要用Vue.js,下面这篇文章主要给大家介绍了关于vue中使用three.js报错的解决方法,文中通过图文以及示例代码介绍的非常详细,需要的朋友可以参考下
    2022-03-03
  • 快速解决 keep-alive 缓存组件中定时器干扰问题

    快速解决 keep-alive 缓存组件中定时器干扰问题

    文章介绍了在使用keep-alive缓存组件时,如何在组件被缓存后清理定时器以避免干扰其他组件的逻辑,通过在deactivated钩子中清理定时器,可以确保组件被缓存时不会继续运行定时器,感兴趣的朋友一起看看吧
    2025-02-02
  • 基于Vue 服务端Cookies删除的问题

    基于Vue 服务端Cookies删除的问题

    今天小编就为大家分享一篇基于Vue 服务端Cookies删除的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-09-09
  • vue elementui 动态追加下拉框、输入框功能

    vue elementui 动态追加下拉框、输入框功能

    这篇文章主要介绍了vue elementui 动态追加下拉框、输入框功能,本文通过示例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2024-04-04
  • vue子元素绑定的事件, 阻止触发父级上的事件处理方式

    vue子元素绑定的事件, 阻止触发父级上的事件处理方式

    这篇文章主要介绍了vue子元素绑定的事件, 阻止触发父级上的事件处理方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-11-11
  • vue jsx 使用指南及vue.js 使用jsx语法的方法

    vue jsx 使用指南及vue.js 使用jsx语法的方法

    这篇文章主要介绍了vue jsx 使用指南及vue.js 使用jsx语法的方法,非常不错,具有参考借鉴价值,需要的朋友可以参考下
    2017-11-11
  • Vue监听属性图文实例详解

    Vue监听属性图文实例详解

    监听属性可以针对某个属性进行监听,当监听的属性的值发生了变化,则会执行相应的函数,下面这篇文章主要给大家介绍了关于Vue监听属性的相关资料,需要的朋友可以参考下
    2021-11-11

最新评论