主题
Validator 表单验证
独立的同步表单验证工具,不需要渲染表单组件。
支持平台
以下为官网文档所列的平台支持情况,具体功能及版本限制请参见本页的平台说明。
| App-vue | App-nvue | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 | H5 | PC | 快手小程序 | 钉钉小程序 |
|---|---|---|---|---|---|---|---|---|---|---|
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
基础用法
js
import validator from '@/components/fui-validator/fui-validator.js';
// 验证姓名字段
const formData = { name: '' };
const rules = [{ name: 'name', rule: ['required'], msg: ['请输入姓名'] }];
const result = validator.validator(formData, rules);方法
validator(formData, rules, checkAll = false) 返回 { isPassed, errorMsg }。默认返回首个错误字符串;checkAll 为 true 时返回错误数组。
规则项的 name 对应数据字段,rule 和 msg 按位置对应;validator 字段可配置自定义方法。内置规则包括 required、isMobile、isEmail、isCarNo、isIdCard、isAmount、isNumber、isChinese、isNotChinese、isEnglish、isEnAndNo、isEnOrNo、isSpecial、isEmoji、isDate、isUrl、isSame、range、minLength、maxLength 和 isKeyword。
带参数的规则可写成 minLength:2、isSame:字段名 或 range:[1,9]。无 required 规则且值为空时,该字段跳过验证。服务端仍需校验提交数据。
事件
| 事件 | 说明 | 回调参数 |
|---|---|---|
| — | 无自定义事件 | — |
插槽
| 插槽 | 说明 |
|---|---|
| — | 官网未列出该组件的插槽 |