在项目中,我们时刻都需要做表单验证。在网上找到一个很好用的表单验证的封装,忘记是谁的了。
- 首先在工具类,也就是utils文件夹下创建一个validate.js文件。
/**
* 表单验证
*
* @param {Object} rules 验证字段的规则
* @param {Object} messages 验证字段的提示信息
*
*/
class Validate {
constructor(rules = {}, messages = {}) {
Object.assign(this, {
data: {},
rules,
messages,
});
this.__init();
}
/**
* __init
*/
__init () {
this.__initMethods();
this.__initDefaults();
this.__initData();
}
/**
* 初始化数据
*/
__initData () {
this.form = {};
this.errorList = [];
}
/**
* 初始化默认提示信息
*/
__initDefaults () {
this.defaults = {
messages: {
required: '这是必填字段。',
email: '请输入有效的电子邮件地址。',
tel: '请输入11位的手机号码。',
url: '请输入有效的网址。',
date: '请输入有效的日期。',
dateISO: '请输入有效的日期(ISO),例如:2009-06-23,1998/01/22。',
number: '请输入有效的数字。',
digits: '只能输入数字。',
idcard: '请输入18位的有效身份证。',
equalTo: this.formatTpl('输入值必须和 {0} 相同。'),
contains: this.formatTpl('输入值必须包含 {0}。'),
minlength: this.formatTpl('最少要输入 {0} 个字符。'),
maxlength: this.formatTpl('最多可以输入 {0} 个字符。'),
rangelength: this.formatTpl('请输入长度在 {0} 到 {1} 之间的字符。'),
min: this.formatTpl('请输入不小于 {0} 的数值。'),
max: this.formatTpl('请输入不大于 {0} 的数值。'),
range: this.formatTpl('请输入范围在 {0} 到 {1} 之间的数值。'),
}
};
}
/**
* 初始化默认验证方法
*/
__initMethods () {
const that = this;
that.methods = {
/**
* 验证必填元素
*/
required (value, param) {
if (!that.depend(param)) {
return 'dependency-mismatch';
} else if (typeof value === 'number') {
value = value.toString();
} else if (typeof value === 'boolean') {
return !0;
}
return value.length > 0;
},
/**
* 验证电子邮箱格式
*/
email (value) {
return that.optional(value) || /^[a-zA-Z0-9.!#$%&'*+\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/.test(value);
},
/**
* 验证手机格式
*/
tel (value) {
return that.optional(value) || /^1[3456789]\d{9}$/.test(value);
},
/**
* 验证URL格式
*/
url (value) {
return that.optional(value) || /^(?:(?:(?:https?|ftp):)?\/\/)(?:\S+(?::\S*)?@)?(?:(?!(?:10|127)(?:\.\d{1,3}){3})(?!(?:169\.254|192\.168)(?:\.\d{1,3}){2})(?!172\.(?:1[6-9]|2\d|3[0-1])(?:\.\d{1,3}){2})(?:[1-9]\d?|1\d\d|2[01]\d|22[0-3])(?:\.(?:1?\d{1,2}|2[0-4]\d|25[0-5])){2}(?:\.(?:[1-9]\d?|1\d\d|2[0-4]\d|25[0-4]))|(?:(?:[a-z\u00a1-\uffff0-9]-*)*[a-z\u00a1-\uffff0-9]+)(?:\.(?:[a-z\u00a1-\uffff0-9]-*)*[a-z\u00a1-\uffff0-9]+)*(?:\.(?:[a-z\u00a1-\uffff]{2,})).?)(?::\d{2,5})?(?:[/?#]\S*)?$/i.test(value);
},
/**
* 验证日期格式
*/
date (value) {
return that.optional(value) || !/Invalid|NaN/.test(new Date(value).toString());
},
/**
* 验证ISO类型的日期格式
*/
dateISO (value) {
return that.optional(value) || /^\d{4}[\/\-](0?[1-9]|1[012])[\/\-](0?[1-9]|[12][0-9]|3[01])$/.test(value);
},
/**
* 验证十进制数字
*/
number (value) {
return that.optional(value) || /^(?:-?\d+|-?\d{1,3}(?:,\d{3})+)?(?:\.\d+)?$/.test(value);
},
/**
* 验证整数
*/
digits (value) {
return that.optional(value) || /^\d+$/.test(value);
},
/**
* 验证身份证号码
*/
idcard (value) {
return that.optional(value) || /^[1-9]\d{5}[1-9]\d{3}((0\d)|(1[0-2]))(([0|1|2]\d)|3[0-1])\d{3}([0-9]|X)$/.test(value);
},
/**
* 验证两个输入框的内容是否相同
*/
equalTo (value, param) {
return that.optional(value) || value === that.data[param];
},
/**
* 验证是否包含某个值
*/
contains (value, param) {
return that.optional(value) || value.indexOf(param) >= 0;
},
/**
* 验证最小长度
*/
minlength (value, param) {
return that.optional(value) || value.length >= param;
},
/**
* 验证最大长度
*/
maxlength (value, param) {
return that.optional(value) || value.length <= param;
},
/**
* 验证一个长度范围[min, max]
*/
rangelength (value, param) {
return that.optional(value) || (value.length >= param[0] && value.length <= param[1]);
},
/**
* 验证最小值
*/
min (value, param) {
return that.optional(value) || value >= param;
},
/**
* 验证最大值
*/
max (value, param) {
return that.optional(value) || value <= param;
},
/**
* 验证一个值范围[min, max]
*/
range (value, param) {
return that.optional(value) || (value >= param[0] && value <= param[1]);
},
};
}
/**
* 添加自定义验证方法
* @param {String} name 方法名
* @param {Function} method 函数体,接收两个参数(value, param),value表示元素的值,param表示参数
* @param {String} message 提示信息
*/
addMethod (name, method, message) {
this.methods[name] = method;
this.defaults.messages[name] = message !== undefined ? message : this.defaults.messages[name];
}
/**
* 判断验证方法是否存在
*/
isValidMethod (value) {
let methods = [];
for (let method in this.methods) {
if (method && typeof this.methods[method] === 'function') {
methods.push(method);
}
}
return methods.indexOf(value) !== -1;
}
/**
* 格式化提示信息模板
*/
formatTpl (source, params) {
const that = this;
if (arguments.length === 1) {
return function () {
let args = Array.from(arguments);
args.unshift(source);
return that.formatTpl.apply(this, args);
};
}
if (params === undefined) {
return source;
}
if (arguments.length > 2 && params.constructor !== Array) {
params = Array.from(arguments).slice(1);
}
if (params.constructor !== Array) {
params = [params];
}
params.forEach(function (n, i) {
source = source.replace(new RegExp("\\{" + i + "\\}", "g"), function () {
return n;
});
});
return source;
}
/**
* 判断规则依赖是否存在
*/
depend (param) {
switch (typeof param) {
case 'boolean':
param = param;
break;
case 'string':
param = !!param.length;
break;
case 'function':
param = param();
default:
param = !0;
}
return param;
}
/**
* 判断输入值是否为空
*/
optional (value) {
return !this.methods.required(value) && 'dependency-mismatch';
}
/**
* 获取自定义字段的提示信息
* @param {String} param 字段名
* @param {Object} rule 规则
*/
customMessage (param, rule) {
const params = this.messages[param];
const isObject = typeof params === 'object';
if (params && isObject) return params[rule.method];
}
/**
* 获取某个指定字段的提示信息
* @param {String} param 字段名
* @param {Object} rule 规则
*/
defaultMessage (param, rule) {
let message = this.customMessage(param, rule) || this.defaults.messages[rule.method];
let type = typeof message;
if (type === 'undefined') {
message = `Warning: No message defined for ${rule.method}.`;
} else if (type === 'function') {
message = message.call(this, rule.parameters);
}
return message;
}
/**
* 缓存错误信息
* @param {String} param 字段名
* @param {Object} rule 规则
* @param {String} value 元素的值
*/
formatTplAndAdd (param, rule, value) {
let msg = this.defaultMessage(param, rule);
this.errorList.push({
param: param,
msg: msg,
value: value,
});
}
/**
* 验证某个指定字段的规则
* @param {String} param 字段名
* @param {Object} rules 规则
* @param {Object} data 需要验证的数据对象
*/
checkParam (param, rules, data) {
// 缓存数据对象
this.data = data;
// 缓存字段对应的值
const value = data[param] !== null && data[param] !== undefined ? data[param] : '';
// 遍历某个指定字段的所有规则,依次验证规则,否则缓存错误信息
for (let method in rules) {
// 判断验证方法是否存在
if (this.isValidMethod(method)) {
// 缓存规则的属性及值
const rule = {
method: method,
parameters: rules[method]
};
// 调用验证方法
const result = this.methods[method](value, rule.parameters);
// 若result返回值为dependency-mismatch,则说明该字段的值为空或非必填字段
if (result === 'dependency-mismatch') {
continue;
}
this.setValue(param, method, result, value);
// 判断是否通过验证,否则缓存错误信息,跳出循环
if (!result) {
this.formatTplAndAdd(param, rule, value);
break;
}
}
}
}
/**
* 设置字段的默认验证值
* @param {String} param 字段名
*/
setView (param) {
this.form[param] = {
$name: param,
$valid: true,
$invalid: false,
$error: {},
$success: {},
$viewValue: ``,
};
}
/**
* 设置字段的验证值
* @param {String} param 字段名
* @param {String} method 字段的方法
* @param {Boolean} result 是否通过验证
* @param {String} value 字段的值
*/
setValue (param, method, result, value) {
const params = this.form[param];
params.$valid = result;
params.$invalid = !result;
params.$error[method] = !result;
params.$success[method] = result;
params.$viewValue = value;
}
/**
* 验证所有字段的规则,返回验证是否通过
* @param {Object} data 需要验证数据对象
*/
checkForm (data) {
this.__initData();
for (let param in this.rules) {
this.setView(param);
this.checkParam(param, this.rules[param], data);
}
return this.valid();
}
/**
* 返回验证是否通过
*/
valid () {
return this.size() === 0;
}
/**
* 返回错误信息的个数
*/
size () {
return this.errorList.length;
}
/**
* 返回所有错误信息
*/
validationErrors () {
return this.errorList;
}
}
export default Validate;
- 在要使用的地方,加入form.js。列如,我们在登录页文件中使用表单验证,则在该目录下创建form.js文件。目录结构如图所示:
2.form.js中的内容
const rules = {
username: {
required: true,
tel: true
},
password: {
required: true
}
};
const messages = {
username: {
required: '手机号不能为空',
tel: '请输入正确的手机号',
},
password: {
required: '密码不能为空'
}
};
const formList = [
{
id: 1,
title: '手机号',
name: 'username',
type: 'text',
placeholder: '请输入您的手机号',
err: false,
maxlength: 11,
msg: ''
},
{
id: 2,
title: '密码',
name: 'password',
type: 'password',
placeholder: '请输入您的密码',
maxlength: 15,
err: false,
msg: ''
},
];
export {formList, rules, messages};
3.使用验证
先引入我们方法
import { formList, rules, messages } from "./form";
import Validate from "../../../utils/validate";
//定义formList
export default () => {
const [formContent, setFormContent] = React.useState(formList);
const validate = new Validate(rules, messages);
const submit = (event) => {
const { value } = event.detail;
submitForm(value);
};
const submitForm = (value) => {
if (!validate.checkForm(value)) {
const err = validate.errorList;
err.map((item) => {
formContent.map((fItem) => {
if (fItem.name === item.param) {
fItem.err = true;
fItem.msg = item.msg;
}
});
});
setFormContent([...formContent]);
} else {
// showLoading({ title: '正在登录...' }).catch();
token(value).then((res) => {
if (res.status === 200) {
const { access, refresh } = res.data;
setStorage({
key: 'token',
data: access
}).catch();
setStorage({
key: 'refresh',
data: refresh
}).catch();
getUserInfo().then((res) => {
const { info } = res.data;
if (info) {
setStorage({
key: 'info',
data: JSON.stringify(info)
}).catch();
user.setInfo(info);
}
showToast({ title: '登录成功!' }).catch();
setTimeout(function () {
navigateBack({ delta: 1 }).catch();
}, 1000)
});
}
}).catch((err) => {
const { status } = err.response;
if (status === 401) {
showToast({
title: '抱歉,账号密码有误',
icon: 'none'
}).catch();
}
}).finally(() => {
// hideLoading().catch();
});
}
};
}
html页
<Form className={styles.form} bindsubmit={submit}>
{
formContent.map((item, index) => {
if (item.name === 'username') {
return (
<View key={index}>
<Text className={styles.err}>{item.err ? item.msg : ''}</Text>
<View className={styles.itemPhone} key={item.id}>
<Image className={styles.img} src={CenterImg} />
<View className={styles.left}>
<Input className={styles.input}
name={item.name}
placeholder={item.placeholder}
maxlength={11}
value={mobile}
/>
</View>
</View>
</View>
);
} else if (item.name === 'password') {
return (
<View key={index}>
<Text className={styles.err}>{item.err ? item.msg : ''}</Text>
<View className={styles.itemCode} key={item.id}>
<Image className={styles.passImg} src={passwordImg} />
<View className={styles.left}>
<Input className={styles.input}
name={item.name}
type={item.type}
value={password}
placeholder={item.placeholder}
maxlength={20}
/>
</View>
</View>
</View>
);
}
return (
<View className={styles.item} key={item.id}>
<Text className={styles.err}>{item.err ? item.msg : ''}</Text>
<Input className={styles.input}
name={item.name}
type={item.type}
maxlength={11}
value={company}
bindinput={(event) => {
inputChange(event, item.name);
}}
placeholder={item.placeholder} />
</View>
);
})
}
<View className={styles.item}>
<Button className={styles.login} formType={'submit'}>立即登录</Button>
</View>
<View className={styles.item}>
<Text className={styles.sign} onClick={toSign}>重置密码</Text>
<Text className={styles.register} onClick={toReset}>注册一个账号</Text>
</View>
</Form>
代码主要是在remax中的使用,在其他框架使用也差不多。
最后,希望能帮助到各位。