校验规则 Rules

表单组件的校验规则

基本用法

校验的功能需要配合林间有风提供的表单组件使用。

在表单项上设置 rules 属性,rules 接收一个数组或者对象;

当失去焦点时触发校验事件,可通过 linvalidate 事件监听校验结果;

此外,还提供了三种错误提示的方式:messagetoasttext ,通过设置 tipType的值为 messagetoasttext 开启提示信息。

示例代码

  1. <l-input label="邮箱" placeholder="请输入邮箱" label-width="170"
  2. name="email" rules="{{emailRules}}" />
  3. <l-input label="用户名" placeholder="请输入用户名" label-width="170"
  4. name="user" rules="{{userRules}}" />
  1. data: {
  2. userRules: [{
  3. required: true
  4. },
  5. {
  6. min: 2,
  7. max: 5,
  8. message: '长度需要在2-3个字符之间'
  9. }
  10. ],
  11. emailRules: {
  12. type: 'email',
  13. required: true
  14. }
  15. },

校验规则属性 (Rules Attributes)

参数说明类型可选值默认值
enum枚举类型String--
len字段长度Number--
max最大长度Number--
message校验错误提示文案String--
min最小长度Number--
pattern正则表达式校验String--
required是否必选Boolean-false
type内建校验类型String见下表string
whitespace必选时,空格是否会被视为错误Boolean-false

更多高级用法可研究 async-validator校验规则 Rules - 图1

TIP

提示:pattern属性的值需是 String,传入正则时,微信小程序不识别,会导致传入的 pattern 是个空的对象。

内置校验类型 (Type Value)

参数说明
string字符串
number数字
boolean布尔
method方法
regexp正则
integer整数
float浮点数字
array数组
object对象
enum枚举类型,值必须存在 enum 中
date日期
url网址
email邮箱
hex16进制

监听校验事件

事件名称说明返回值备注
bind:linvalidate监听校验结果{error,isError}-