小程序表單校驗(yàn)uni-forms的正確使用方式以及避坑指南
一、前言
小程序上使用表單理應(yīng)是很常用,也很必須的功能,因?yàn)橄到y(tǒng)實(shí)用了uni-app,所以這時(shí)候會(huì)用到uni-forms,但使用過程中遇到不少問題。
這邊的需求有3個(gè):
即時(shí)校驗(yàn)(輸入框失焦立即校驗(yàn)值)需自定義校驗(yàn)規(guī)則需要異步校驗(yàn)
滿足這3個(gè)需求,就能實(shí)現(xiàn)絕大部分表單校驗(yàn),然而直接使用官方的案例并不能滿足,踩過不少坑,最后解決方案如下。
二、成果展示
以下展示均滿足上述3個(gè)需求,下面示例代碼可以直接看 第六點(diǎn)

三、uni-forms即時(shí)校驗(yàn)
實(shí)現(xiàn)即時(shí)校驗(yàn),uni-forms需要加validate-trigger="bind",同時(shí)input添加@blur="binddata('字段名', $event.detail.value)"
示例:
<uni-forms ref="form" :modelValue="ruleForm" validate-trigger="bind">
<uni-forms-item label="賬號(hào)" name="account">
<input v-model.trim="ruleForm.account"
@blur="binddata('account', $event.detail.value)"
placeholder="請(qǐng)輸入您的登錄賬號(hào)" />
</uni-forms-item>
</uni-forms>
四、uni-forms自定義校驗(yàn)規(guī)則
需要自定義校驗(yàn)規(guī)則時(shí),去掉uni-forms的:rules,同時(shí)onReady里加this.$refs.form.setRules(this.rules),其中validateFunction: this.checkEmail為自定義校驗(yàn)方法
示例:
<template>
<uni-forms ref="form" :modelValue="ruleForm" validate-trigger="bind">
......
</uni-forms>
</template>
<script>
export default {
data() {
return {
// 校驗(yàn)規(guī)則
rules: {
email: {
rules: [
{
validateFunction: this.checkEmail,
},
],
},
},
};
},
onReady() {
// 需要在onReady中設(shè)置規(guī)則
this.$refs.form.setRules(this.rules);
},
methods: {
/**
* 表單驗(yàn)證郵箱
*/
checkEmail(rule, value, allData, callback) {
if (value !== "" && !verifyEmail(value)) {
return callback("郵箱不正確");
}
callback();
},
},
};
</script>五、uni-forms異步校驗(yàn)
通常使用異步方法來校驗(yàn)賬號(hào)是否重復(fù)等,步驟:
- 首先需要自定義校驗(yàn)方法validateFunction: this.checkAccount
- 然后進(jìn)行常規(guī)的規(guī)則校驗(yàn)
- 再進(jìn)行異步方法校驗(yàn)賬號(hào)唯一性
需要使用Promise,校驗(yàn)通過使用 return resolve()
校驗(yàn)失敗使用 return reject(new Error('錯(cuò)誤提示信息'))
示例(核心代碼部分):
export default {
data() {
return {
// 校驗(yàn)規(guī)則
rules: {
account: {
rules: [
{
required: true,
errorMessage: '請(qǐng)輸入您的賬號(hào)',
},
{
validateFunction: this.checkAccount,
},
],
},
},
};
},
methods: {
// 表單驗(yàn)證賬號(hào)
checkAccount(rule, value) {
return new Promise((resolve, reject) => {
// 先進(jìn)行規(guī)則校驗(yàn)
if (value === '' || !verifyAccount(value)) {
return reject(new Error('只能輸入4-30位英文、數(shù)字、下劃線'))
}
// 再進(jìn)行異步校驗(yàn),checkUser為本系統(tǒng)api異步方法,結(jié)合你系統(tǒng)使用你自己的方法
apiCheckAccount({ account: value })
.then((data) => {
if (data.exist) {
return reject(new Error('賬號(hào)已存在'))
}
resolve()
})
.catch((err) => {
return reject(new Error(err.message))
})
})
},
},
六、完整示例源碼
<template>
<view class="register">
<view class="title">最實(shí)用表單校驗(yàn)</view>
<uni-forms ref="form" :modelValue="ruleForm" validate-trigger="bind" label-width="40">
<uni-forms-item label="賬號(hào)" name="account">
<input v-model.trim="ruleForm.account" @blur="binddata('account', $event.detail.value)" placeholder="請(qǐng)輸入您的登錄賬號(hào)" />
</uni-forms-item>
<uni-forms-item label="姓名" name="name">
<input v-model.trim="ruleForm.name" @blur="binddata('name', $event.detail.value)" placeholder="請(qǐng)輸入您的姓名" />
</uni-forms-item>
<uni-forms-item class="form-item-center">
<button type="primary" @click="submit()">注冊(cè)</button>
</uni-forms-item>
</uni-forms>
</view>
</template>
<script>
import { apiCheckAccount } from '@/api'
import { verifyAccount, verifyName } from '@/utils'
export default {
data() {
return {
// 表單數(shù)據(jù)
ruleForm: {
account: '', // 賬號(hào)
name: '', // 姓名
},
rules: {},
}
},
onReady() {
this.setRules()
// 需要在onReady中設(shè)置規(guī)則
this.$refs.form.setRules(this.rules)
},
methods: {
// 提交表單
submit() {
this.$refs.form
.validate()
.then(() => {
uni.showToast({
title: '注冊(cè)成功!',
duration: 2000,
icon: 'success',
})
})
.catch((err) => {
console.log('表單校驗(yàn)失?。?, err)
})
},
// 設(shè)置校驗(yàn)規(guī)則
setRules() {
this.rules = {
account: {
rules: [
{
required: true,
errorMessage: '請(qǐng)輸入您的賬號(hào)',
},
{
validateFunction: this.checkAccount,
},
],
},
name: {
rules: [
{
required: true,
errorMessage: '請(qǐng)輸入您的姓名',
},
{
validateFunction: this.checkName,
},
],
},
}
},
// 驗(yàn)證賬號(hào)
checkAccount(rule, value) {
return new Promise((resolve, reject) => {
// 先進(jìn)行規(guī)則校驗(yàn)
if (value === '' || !verifyAccount(value)) {
return reject(new Error('只能輸入4-30位英文、數(shù)字、下劃線'))
}
// 再進(jìn)行異步校驗(yàn),checkUser為本系統(tǒng)api異步方法,結(jié)合你系統(tǒng)使用你自己的方法
apiCheckAccount({ account: value })
.then((data) => {
if (data.exist) {
return reject(new Error('賬號(hào)已存在'))
}
resolve()
})
.catch((err) => {
return reject(new Error(err.message))
})
})
},
// 驗(yàn)證姓名
checkName(rule, value, allData, callback) {
if (!verifyName(value)) {
return callback('只能輸入1-30位中英文和數(shù)字')
}
callback()
},
},
}
</script>
補(bǔ)充:記錄一個(gè)uni-forms表單每輸入一次就自動(dòng)失去焦點(diǎn)的問題
局部代碼:
我之前是在key里面放了個(gè)input變量進(jìn)去了,這確實(shí)也是個(gè)低級(jí)錯(cuò)誤,但是此類問題的原因應(yīng)該大同小異,就是v-for底層map循環(huán)的時(shí)候,key值發(fā)生了變化,導(dǎo)致dom更新,出現(xiàn)這個(gè)問題,去掉不確定性的key值綁定就好了

所以,用key要謹(jǐn)慎啊!一不小心找bug就是半天過去了
最后
到此這篇關(guān)于小程序表單校驗(yàn)uni-forms正確使用方式以及避坑指南的文章就介紹到這了,更多相關(guān)小程序表單校驗(yàn)uni-forms內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
js showModalDialog參數(shù)的使用詳解
本篇文章主要是對(duì)js中showModalDialog參數(shù)的使用進(jìn)行了詳細(xì)的分析介紹,需要的朋友可以過來參考下,希望對(duì)大家有所幫助2014-01-01
js實(shí)現(xiàn)仿百度汽車頻道選擇汽車圖片展示實(shí)例
這篇文章主要介紹了js實(shí)現(xiàn)仿百度汽車頻道選擇汽車圖片展示,實(shí)例分析了javascript鼠標(biāo)事件操作css樣式的技巧,非常具有實(shí)用價(jià)值,需要的朋友可以參考下2015-05-05

