溫馨提示×

溫馨提示×

您好,登錄后才能下訂單哦!

密碼登錄×
登錄注冊×
其他方式登錄
點(diǎn)擊 登錄注冊 即表示同意《億速云用戶服務(wù)條款》

Vue Element-ui如何實(shí)現(xiàn)表單校驗(yàn)規(guī)則

發(fā)布時(shí)間:2021-07-09 18:27:53 來源:億速云 閱讀:482 作者:chen 欄目:開發(fā)技術(shù)

本篇內(nèi)容介紹了“Vue Element-ui如何實(shí)現(xiàn)表單校驗(yàn)規(guī)則”的有關(guān)知識,在實(shí)際案例的操作過程中,不少人都會遇到這樣的困境,接下來就讓小編帶領(lǐng)大家學(xué)習(xí)一下如何處理這些情況吧!希望大家仔細(xì)閱讀,能夠?qū)W有所成!

目錄
  • 1、前言

  • 2、規(guī)則校驗(yàn)的入門模式

    • 2.1、示例代碼

    • 2.2、form項(xiàng)

    • 2.3、prop項(xiàng)

    • 2.4、rules項(xiàng)

    • 2.5、rule項(xiàng)

    • 2.6、使用規(guī)則

    • 2.7、規(guī)則校驗(yàn)的核心

  • 3、規(guī)則校驗(yàn)的進(jìn)階模式

    • 3.1、嵌套對象屬性名

    • 3.2、自定義校驗(yàn)器validator

    • 3.3、類型type

    • 3.3、數(shù)據(jù)轉(zhuǎn)換transform

    • 3.4、數(shù)值范圍Range

    • 3.5、枚舉值

    • 3.6、正則Pattern

    • 3.7、長度len

    • 3.8、空白whitespace

    • 3.9、i18n

  • 4、規(guī)則校驗(yàn)的高級模式

    • 4.1、異步校驗(yàn)器asyncValidator

    • 4.2、深層規(guī)則Deep rules

    • 4.3、動態(tài)規(guī)則集

      • 4.3.1、切換校驗(yàn)規(guī)則集

      • 4.3.2、動態(tài)構(gòu)建校驗(yàn)規(guī)則集

    • 4.4、動態(tài)表格字段校驗(yàn)

      • 4.5、多字段聯(lián)合校驗(yàn)

      • 5、參考文章

        1、前言

        ??Element-ui表單校驗(yàn)規(guī)則,使得錯(cuò)誤提示可以直接在form-item下面顯示,無需彈出框,因此還是很好用的。

        ??我在做了登錄頁面的表單校驗(yàn)后,一度以為我已經(jīng)很了解表單的校驗(yàn)規(guī)則。但我在深入使用表單校驗(yàn)規(guī)則時(shí),遇到下列問題:

        • 如何判斷屬性值是否在某個(gè)范圍內(nèi),且這個(gè)范圍可以任意指定?

        • 如何判斷屬性值是否為某個(gè)值?

        • 多個(gè)屬性聯(lián)合校驗(yàn),當(dāng)前屬性的校驗(yàn)規(guī)則依賴于另一個(gè)屬性的值,如何進(jìn)行校驗(yàn)?如注冊頁面,ID類型有郵箱地址、手機(jī)號和身份證號碼,選擇不同類型,IDValue屬性的校驗(yàn)規(guī)則是不同,如何處理?

        • 兩種模式,進(jìn)入同一個(gè)表單組件,某些欄位可以不使用校驗(yàn)規(guī)則,即rules的對象會有所不同。這種情況如何處理?

        ??上述問題,讓我感覺幾乎成了小白。于是迫使我從頭開始研究校驗(yàn)規(guī)則,查閱相關(guān)文檔。

        ??本文分享一下對于表單校驗(yàn)規(guī)則的心得體會。

        2、規(guī)則校驗(yàn)的入門模式

        2.1、示例代碼

        ??作為規(guī)則校驗(yàn)的入門,以登錄頁面為例,代碼如下:

        <template> 
          <div class="login-container">    
            <el-form ref="form" :model="form" :rules="rules" label-width="80px" class="login-form">
              <h3 class="login-title">XX管理系統(tǒng)登錄</h3>
              <el-form-item label="用戶名:" prop="username">
                <el-input v-model="form.username"></el-input>
              </el-form-item>
              <el-form-item label="密  碼:" prop="password">
                <el-input v-model="form.password" type="password"></el-input>
              </el-form-item>
              <el-form-item label="驗(yàn)證碼:" prop="verifyCode">
                <el-input v-model="form.verifyCode"></el-input>
                <div class="divVerifyCodeImg" @click="getVerifyCode(true)">
                  <img id="verifyCodeImg"  alt="點(diǎn)擊更換" title="點(diǎn)擊更換" />
                </div>
              </el-form-item>
              <el-form-item>
                <el-button type="primary" id="login"  @click="submitForm('form')">登錄</el-button>
              </el-form-item>
            </el-form>
          </div>  
        </template>
        
        <script>
        import { mapMutations } from 'vuex'
        export default {
          data() {
            return {
              form: {
                username: "",
                password: "",
                verifyCode: "",
              },
              rules: {
                username: [
                  {required: true, message: "用戶名不能為空", trigger: 'blur'},
                ],
                password: [
                  {required: true, message: "密碼不能為空", trigger: 'blur'},
                  {min: 6, max: 30, message: "密碼6-30位", trigger: 'blur'}
                ],
                verifyCode: [
                  {required: true, message: "驗(yàn)證碼不能為空", trigger: 'blur'},
                ]
              }      
            };   
          },
          methods: {
            // 提交登錄
            submitForm(formName) { 
              let _this = this;     
              // 執(zhí)行校驗(yàn)
              this.$refs[formName].validate(valid => {
                // 驗(yàn)證通過為true,有一個(gè)不通過就是false
                if (valid) {
                  // 通過校驗(yàn)
                  // 登錄處理
                  // ....
                } else {
                  // 沒通過校驗(yàn)
                  console.log('驗(yàn)證失敗');
                  return false;
                }
              });
            },
          }  
        }
        </script>

        2.2、form項(xiàng)

        ??form項(xiàng),指明使用校驗(yàn)規(guī)則:

         <el-form ref="form" :model="form" :rules="rules" label-width="80px" class="login-form">

        ??:rules="rules" 指明了校驗(yàn)規(guī)則使用rules規(guī)則對象,你也可以使用其它名稱,如rules1。

        2.3、prop項(xiàng)

        ??prop項(xiàng),指明哪些字段可能使用校驗(yàn)規(guī)則:

          <el-form-item label="用戶名:" prop="username">
                <el-input v-model="form.username"></el-input>
              </el-form-item>

        ??如果prop項(xiàng)指定的屬性值,如username,在rules中也有相應(yīng)的項(xiàng),則表示該屬性值執(zhí)行規(guī)則校驗(yàn)。這個(gè)屬性必須是form的model屬性綁定的數(shù)據(jù)對象的屬性,本例中為form,其在data中定義:

          form: {
                username: "",
                password: "",
                verifyCode: "",
              },

        2.4、rules項(xiàng)

        ??rules項(xiàng),即校驗(yàn)規(guī)則集,其在data中定義,其名稱必須與form的:rules屬性綁定的rules規(guī)則對象名一致。

          rules: {
                username: [
                  {required: true, message: "用戶名不能為空", trigger: 'blur'},
                ],
                password: [
                  {required: true, message: "密碼不能為空", trigger: 'blur'},
                  {min: 6, max: 30, message: "密碼6-30位", trigger: 'blur'}
                ],
                verifyCode: [
                  {required: true, message: "驗(yàn)證碼不能為空", trigger: 'blur'},
                ]
              }

        ??這是一個(gè)對象,每個(gè)元素的類型為:{屬性名:[rule]},屬性名對于prop的屬性值。[rule]是一個(gè)規(guī)則數(shù)組,規(guī)則數(shù)組的每一項(xiàng)是一條對本屬性的校驗(yàn)規(guī)則。

        2.5、rule項(xiàng)

        ??rule項(xiàng),即規(guī)則數(shù)組的元素,這是本文要重點(diǎn)探討的項(xiàng)目。這里先就上述rules的各元素項(xiàng)解析一下:

        • required:表示是否必須有值,取值為true/false,如為true,表示必須有值,如果無值,則校驗(yàn)不通過;如為false,則允許無值,但在有值的情況下,不影響其它規(guī)則的使用。

        • message:提示消息,在校驗(yàn)不通過時(shí)提示此消息。

        • trigger:觸發(fā)方式,取值為blur/change,blue表示失去焦點(diǎn),一般在input組件中使用;change為值改變,一般在選擇框中使用。

        • min:字符串最小長度。

        • max:字符串最大長度。

        ??有了這些解釋,不難理解上述rules定義的各屬性的校驗(yàn)規(guī)則。

        2.6、使用規(guī)則

        this.$refs[‘form'].validate(valid => {
                // 驗(yàn)證通過為true,有一個(gè)不通過就是false
                if (valid) {
                  // 通過校驗(yàn)
                } else {
                  // 沒通過校驗(yàn)
                }
              });

        ??這個(gè)validate方法,要求所有校驗(yàn)規(guī)則都通過,才放行。其中,$refs[‘form'],指向form的ref屬性值。

        2.7、規(guī)則校驗(yàn)的核心

        ??規(guī)則校驗(yàn)的核心為為async-validator插件,官網(wǎng):https://github.com/yiminghe/async-validator。

        ??Element-UI使用了該插件,并進(jìn)行了封裝。官網(wǎng):https://element.eleme.cn/#/zh-CN/component/form。

        ??因此兩邊的資料都會有幫助。

        3、規(guī)則校驗(yàn)的進(jìn)階模式

        3.1、嵌套對象屬性名

        ??有時(shí)候,prop不是一個(gè)簡單的屬性,而是包在其它對象下的屬性。如:

          <el-form-item label="登 錄 名:" prop="formData.loginName">
                <el-input v-model="form.formData.loginName" :disabled="form.formData.userId != 0"></el-input>
              </el-form-item>

        ??form的model綁定的form對象,其形式為:

        form:{
                  // form數(shù)據(jù)字段,為提交后端方便,建議與UserInfo字段命名一致
                  formData    : {
                    userId      : 0,
                    loginName   : '',
                    passwd      : '',
                    // ...
                  },
        
                  // 用戶類型選擇框當(dāng)前顯示值
                  userTypeLabel : "",
                  // ...
                },

        ??此時(shí),rules的元素定義,不能用下列形式:

        formData.loginName: [
                  {required: true, message: "登錄名不能為空", trigger: 'blur'},
                ],

        ??這樣,編譯會報(bào)錯(cuò)!

        ??應(yīng)使用下列形式:

        'formData.loginName': [
              {required: true, message: "登錄名不能為空", trigger: 'blur'},
            ],

        ??即用單引號或雙引號將之包起來,變成一個(gè)字符串。

        3.2、自定義校驗(yàn)器validator

        ??關(guān)于自定義校驗(yàn)器validator,網(wǎng)上的相關(guān)資料很多,如常用正則檢查的validator。

        ??規(guī)則定義方法:

          'formData.loginName': [
                    {required: true, message: "登錄名不能為空", trigger: 'blur'},
                    {validator:loginNameValidator, trigger: 'blur'}
                  ],

        ??表示'formData.loginName'屬性使用了loginNameValidator的校驗(yàn)器。考慮到代碼的復(fù)用,一般將自定義的校驗(yàn)器獨(dú)成了js文件,便于其它頁面或項(xiàng)目使用。

        ??在/src/common/目錄下,創(chuàng)建validator.js文件,代碼如下:

        /* 登錄名校驗(yàn) */
        export function loginNameValidator(rule, value, callback){
          const reg= /^[a-zA-Z][\w-. @]*$/;
          if(value == '' || value == undefined || value == null){
            callback();
          }else {  
            if (!reg.test(value)){
              callback(new Error('要求為:英文字母開頭,后續(xù)為字母數(shù)字及_-. @符號'));
            }else {
              callback();
            }
          }
        }

        ??在vue文件中導(dǎo)入此validator.js文件:

        import {loginNameValidator} from '@/common/validator.js'

        ??如果需導(dǎo)入多個(gè)外部校驗(yàn)器,則在{}中包含多個(gè),如{loginNameValidator,passwordValidator}。

        ??這里有個(gè)小坑,稍微提一句。

        ??根據(jù)目錄結(jié)構(gòu),我先使用下列語句:

        import {loginNameValidator} from '../../../common/validator.js'

        ??結(jié)果,編譯錯(cuò)誤,說找不到'../../../common/validator.js'文件,于是各種路徑表示方法嘗試,均告失敗。最后還是使用改用@通過了,因?yàn)?bulid/webpack.base.conf.js中配置了alias,指示@表示src目錄。

        ??回到自定義validator,其形式為:

        function ValidatorFuncName(rule, value, callback)

        ??方法名,隨意指定。

        ??實(shí)際上,其完整形式為:

        function ValidatorFuncName(rule, value, callback, source, options)

        ??參數(shù)含義如下:

        rule:指向規(guī)則的對象,可以在方法代碼中,加入第一句:

        console.log(rule);

        可將rule參數(shù)打印出來看,就是本條規(guī)則的對象數(shù)據(jù)。

        value:屬性的值,該值為需要校驗(yàn)的值。

        callback:指向校驗(yàn)結(jié)束的回調(diào)函數(shù),如果校驗(yàn)通過,調(diào)用callback(),如果未通過,一般使用下列形式:

        callback(new Error('具體的提示信息'));
        ??或帶參數(shù)的提示:

        return callback(new Error(`${rule.field} must be lowercase alphanumeric characters`));

        ??注意,字符串格式化,不是使用單引號括起來,而是用“~”符號括起來。

        ??也可以使用async-validator官網(wǎng)(https://github.com/yiminghe/async-validator)的方法:

        util.format('%s must be lowercase alphanumeric characters', rule.field),

        ??util文件中包含format方法,這個(gè)util.ts文件,在官網(wǎng)的src/目錄下,這是個(gè)ts文件,可以類似做一個(gè)公共方法。

        ??實(shí)際上,可以返回一個(gè)Error的數(shù)組,即errors,如:

          const errors = [];
              errors.push(new Error('要求為:英文字母開頭,后續(xù)為字母數(shù)字及_-. @符號'));
              errors.push(new Error('3444要求為:英文'));
              return callback(errors);

        ??但從實(shí)際效果看,表單只顯示了第一行的提示,估計(jì)Element的表單不支持顯示多行錯(cuò)誤信息。

        • source:為調(diào)用校驗(yàn)的屬性對象,可以打印出來看一下。

        • options,附加參數(shù),主要是預(yù)定義的消息格式,也可以打印出來看一下。

        ??更復(fù)雜的校驗(yàn)器,可以攜帶參數(shù),如:

        // 整數(shù)范圍值校驗(yàn)
        export const intRangeValidator = (min, max) => (rule, value, callback) => {
          var isInRange = (value >= min) && (value <= max);
          const reg = /^-?\d+$/;
          var isInt = reg.test(value);
          if (isInRange && isInt){
            return callback();
          }else{
            return callback(new Error(`要求是在${min}到${max}的整數(shù) [${min}, ${max}]`));
          }
        }

        ??使用方法:

          'formData.age': [
                {validator: intRangeValidator(1,100), trigger: 'blur'}
              ],

        ??表示,formData.age屬性的取值范圍為1-100的整數(shù)。

        ??自定義校驗(yàn)器validator提供了自由發(fā)揮的空間,可以使用正則匹配、數(shù)值計(jì)算和比較等運(yùn)算等,進(jìn)行復(fù)雜的校驗(yàn),因此比較常用。但用自定義校驗(yàn)器validator,有時(shí)會顯得過于繁瑣。

        ??自定義校驗(yàn)器validator不一定要放置在外部文件中,也可以放置vue文件中。

        ??放置在data中,但不被return所包括的位置,尾部沒有逗號。

        const loginNameValidator = (rule, value, callback) => {
          const reg= /^[a-zA-Z][\w-. @]*$/;
          if(value == '' || value == undefined || value == null){
            callback();
          }else {  
            if (!reg.test(value)){
              callback(new Error('要求為:英文字母開頭,后續(xù)為字母數(shù)字及_-. @符號'));
            }else {
              callback();
            }
          }
        }

        ??或直接在規(guī)則中定義:

          'formData.loginName': [
                    {required: true, message: "登錄名不能為空", trigger: 'blur'},
                    {validator(rule, value, callback){
                      const reg= /^[a-zA-Z][\w-. @]*$/;
                      if(value == '' || value == undefined || value == null){
                        callback();
                      }else {  
                        if (!reg.test(value)){
                          callback(new Error('要求為:英文字母開頭,后續(xù)為字母數(shù)字及_-. @符號'));
                        }else {
                          callback();
                        }
                      }                
                    }, 
                     trigger: 'blur'}
                  ],

        3.3、類型type

        ??類型type的基本用法如下:

          'formData.age': [
                {type: 'integer',message: "值要求為整數(shù)",trigger: 'blur'},
              ],

        ??類型也是一個(gè)規(guī)則項(xiàng),如不符合類型要求,則提示錯(cuò)誤信息。

        ??規(guī)則支持的類型如下:

        • string,字符串類型,這是默認(rèn)類型。如不指定type,默認(rèn)就是string。

        • number,數(shù)字類型。包括整數(shù)和小數(shù)。

        • integer,整數(shù)類型。

        • float,浮點(diǎn)數(shù)類型,此時(shí)不能為整數(shù),必須有小數(shù)點(diǎn)。

        • boolean,布爾類型,true/false值。

        • array,數(shù)組類型。

        • object,對象類型,不能為數(shù)組。

        • enum,枚舉類型,然后需要聲明該枚舉類型。

        • method,函數(shù)(或方法)類型。

        • regexp,正則類型,必須是一個(gè)合法的正則表達(dá)式,可以通過new RegExp來創(chuàng)建。

        • date,日期類型,值必須可以轉(zhuǎn)為有效日期值。

        • url,url類型,值需要符合url格式。

        • email,email類型,符合郵箱格式格式。

        • hex,16進(jìn)制表示的形式。如0xFF12。

        • any,任意類型,不限制。

        ??這里的url和email類型,可以直接用于相關(guān)含義的屬性校驗(yàn),如:

          'formData.email': [
                    {type: 'email', message: "必須符合郵箱地址格式",trigger: 'blur'}
                  ],

        ??日期類型也比較有用,這些內(nèi)置類型,使得我們可以不必通過自定義校驗(yàn)器validator來處理。

        ??對于數(shù)值類型(number,integer,float)以及boolean型,由于input輸入的都為字符串,因此必須進(jìn)行類型轉(zhuǎn)換,否則校驗(yàn)通不過。這里涉及到transform的用法。

        3.3、數(shù)據(jù)轉(zhuǎn)換transform

        ??transform是一個(gè)鉤子函數(shù),在開始驗(yàn)證之前可以對數(shù)據(jù)先處理后驗(yàn)證。如下面示例:

          'formData.age': [
                {
                    type: 'integer',
                    message: "值要求為整數(shù)",
                    trigger: 'blur',
                    transform(value){return parseInt(value);},
                },
              ],

        ??經(jīng)過transform類型轉(zhuǎn)化后,formData.age屬性的校驗(yàn)規(guī)則就能正常使用了,否則總是通不過類型校驗(yàn)。(這里實(shí)際上有點(diǎn)問題,如允許輸出12ab這種形式的值,parseInt得到值為12)

        ??對于類型轉(zhuǎn)換,transform還有更簡潔而嚴(yán)格的表述:

          'formData.age': [
            {
                type:'integer',
                message: "值要求為整數(shù)",
                trigger: 'blur',
                transform:Number},
            },
          ],

        ??表示轉(zhuǎn)換為數(shù)字類型,這樣就行了。值為1.2或12ab都不能通過校驗(yàn)。

        ??transform除了類型轉(zhuǎn)換外,還可以進(jìn)行其它處理,如:

          'formData.age': [
                    {type : 'string',pattern:/1/,message: "值要求為1-100的數(shù)",transform(value){return parseInt(value)>=1 && parseInt(value)<=100 ? "1" : "0";},}
                  ],

        ??等于某個(gè)值:

          'formData.age': [
                    {type : 'string',pattern:/1/,message: "值要求必須為50",transform(value){return value == "50" ? "1" : "0";},}
                  ],

        ??不等于某個(gè)值:

          'formData.age': [
                {type : 'string',pattern:/0/,message: "值要求不能為50",transform(value){return value == "50" ? "1" : "0";},}
              ],

        3.4、數(shù)值范圍Range

        ??Range不是規(guī)則的屬性字段,其通過min和max屬性來體現(xiàn)。

        ??如果類型type為string或array,則min和max表示長度。

        ??如果類型type為數(shù)值類型(number,integer,float),則min和max表示值的范圍。如:

          'formData.age': [
            {
                type:'integer',
                message: "值要求為1-100的整數(shù)",
                min: 1,
                max:100,
                trigger:'blur',
                transform:Number,
            },
          ],

        ??這樣,范圍校驗(yàn)直接可使用規(guī)則的內(nèi)置屬性,在規(guī)則中進(jìn)行描述,也無需用intRangeValidator校驗(yàn)器和正則匹配方式了。

        3.5、枚舉值

        ??枚舉值類型的用法示例:

          'formData.idType': [
                    {
                        type: 'enum', enum: [2,4,6], message: `結(jié)果不存在`, trigger: ['change', 'blur'], transform(value) {return Number(value) * 2},
                    },
                  ],  
        ??或:
        
              'formData.gender': [
                {
                    type: 'enum', enum: ['male','female'], message: `結(jié)果不存在`, trigger: ['change', 'blur'],
                },
              ],

        ??使用有下列問題:

        • 反應(yīng)比較遲鈍,就是一開始幾次輸入,沒有校驗(yàn),一旦有校驗(yàn)了,后面都就可以了。

        • 對于后一種情況,即范圍為字符串的集合,校驗(yàn)正常。對于前一種情況,即范圍為整數(shù)型的,0也通過校驗(yàn)了,導(dǎo)致任意字符串也通過校驗(yàn)了,這是一個(gè)bug。

        ??因此,也可以利用字符串枚舉值,來校驗(yàn)范圍:

          'formData.age': [
                    {
                        type : 'enum',
                        enum:["1"],
                        message: "值要求為1-100的數(shù)",
                        transform(value){
                            if (!isNaN(value)){
                              return parseInt(value)>=1 && parseInt(value)<=100 ? "1" : "0";
                            }else{
                              return "0";
                            }
                       }
                    },
                  ],

        ??注意:此時(shí)1e3,9e811被認(rèn)為是通過校驗(yàn)了,因?yàn)閜arseInt函數(shù)只取e前面的數(shù)字,而isNaN認(rèn)為是數(shù)字??磥磉€是需要與正則規(guī)則配合才行。

        3.6、正則Pattern

        ??pattern屬性,就是正則表達(dá)式匹配校驗(yàn)規(guī)則,如:

          'formData.loginName': [
                    {required: true, message: "登錄名不能為空", trigger: 'blur'},
                    {pattern:/^[a-zA-Z][\w-. @]*$/,
                     message:'要求為:英文字母開頭,后續(xù)為字母數(shù)字及_-. @符號',
                     trigger: 'blur'}
                  ],

        ??效果與之前的loginNameValidator校驗(yàn)器相同,區(qū)別在于loginNameValidator可以復(fù)用,保持一個(gè)正則校驗(yàn),如需修改,只需改動一處。而使用pattern則不然。但使用pattern可以少寫自定義校驗(yàn)器,給了用戶一個(gè)選擇。

        ??使用pattern屬性,可以進(jìn)行等于某個(gè)值某個(gè)值的校驗(yàn)。

        ??等于某個(gè)值:

        {pattern:/120/,message:'必須必須為120',trigger: 'blur'}

        ??關(guān)于js正則表達(dá)式,可先用js正則表達(dá)式在線測試工具測試一下,檢查是否達(dá)到預(yù)期效果。js正則表達(dá)式在線測試地址:https://c.runoob.com/front-end/854。

        3.7、長度len

        ??len屬性,如果類型為string或array,則冷表示長度。如果為數(shù)字型,則表示數(shù)字值就是len屬性值。

        ??len屬性與min、max屬性同時(shí)出現(xiàn)了,len屬性有更高的優(yōu)先級。

        ??len屬性,可用于格式化的字符串校驗(yàn),如身份證號碼長度。

        ??len也可用于等于某個(gè)數(shù)值的校驗(yàn),如:

          'formData.age': [
            {
                type:'integer',
                message: "值要求必須為6周歲",
                len: 6,
                trigger:'blur',
                transform:Number,
            },
          ],

        3.8、空白whitespace

        ??空白表示全部由空格組成的字符串,規(guī)則的類型必須為string。如果匹配規(guī)則,則告警提示。如:

          'formData.email': [
                     {whitespace: true, message: '只存在空格', trigger: 'blur'}
                  ],

        ??值為空格,會提示告警。

        ??如果不希望空格干擾校驗(yàn),可用transform來處理:

        transform(value) { return value.trim();}

        3.9、i18n

        ??message支持i18n,即國際化處理,如集成vue-i18n,message屬性的用法如下:

        message: () => this.$t( 'about' )

        ??中文語言顯示“關(guān)于”,英文語言顯示“about”。

        ??當(dāng)然,你也可以換成任意的其它函數(shù),如:

        message: () => this.myMessageHandler(MessageId,paramValues)

        4、規(guī)則校驗(yàn)的高級模式

        4.1、異步校驗(yàn)器asyncValidator

        ??異步校驗(yàn)器用于遠(yuǎn)程訪問,利用ajax或axios請求數(shù)據(jù),對響應(yīng)數(shù)據(jù)進(jìn)行校驗(yàn)或?qū)Ξ惓_M(jìn)行提示。

        ??本地頁面校驗(yàn),屬于串行校驗(yàn),逐個(gè)檢查各字段的校驗(yàn)規(guī)則,遇到未通過即返回校驗(yàn)失敗。

        ??遠(yuǎn)程校驗(yàn),為異步校驗(yàn),多個(gè)請求,響應(yīng)時(shí)間各有不同,響應(yīng)的先后次序就無法預(yù)知。

        ??異步校驗(yàn)的作用:可以將前端和后端針對相同屬性字段,使用相同的校驗(yàn)規(guī)則,統(tǒng)一由后端提供校驗(yàn)。但這同樣增加了前后端溝通和一致性維護(hù)的成本。

        ??目前暫時(shí)未用到異步校驗(yàn)器,這里用官網(wǎng)的示例:

        asyncField1:{asyncValidator: myAsyncValidator}
        ??myAsyncValidator可類似validator位置放置。假設(shè)放置在data中。
        
        const myAsyncValidator = (rule, value, callback) => {
              ajax({
                url: 'xx',
                value: value,
              }).then(function(data) {
                callback();
              }, function(error) {
                callback(new Error(error));
              });
            }

        ??Promise異步字段校驗(yàn):

         const myAsyncValidator = (rule, value) => {
              return ajax({
                url: 'xx',
                value: value,
              });
            }

        ??區(qū)別在于Promise異步字段校驗(yàn),需要使用者自己寫上.then/.catch處理邏輯,不支持回調(diào)。

        ??異步校驗(yàn),還涉及到Options屬性,

        options: { first: true },

        ??first為true,表示多個(gè)異步校驗(yàn)遇到第一校驗(yàn)失敗就不再處理其它異步校驗(yàn)。

        4.2、深層規(guī)則Deep rules

        ??對于對象Object或數(shù)組Array的校驗(yàn),需要具體到每一個(gè)元素(成員),這里就要用到Deep rules。

        ??Deep rules涉及到fields和defaultField兩個(gè)屬性。

        ??如官網(wǎng)示例(按照習(xí)慣形式略作修改):

        ??對象的深層校驗(yàn):

        rules : {
          address: [{
            type: 'object',
            required: true,
            options: { first: true },
            fields: {
              street: [{ type: 'string', required: true }],
              city: [{ type: 'string', required: true }],
              zip: [{ type: 'string', required: true, len: 8, message: 'invalid zip' }],
            },
          }],
          name: [{ type: 'string', required: true }],
        };

        ??數(shù)組的深層校驗(yàn):

        rules : {
          roles: [{
            type: 'array',
            required: true,
            len: 3,
            fields: {
              0: [{ type: 'string', required: true }],
              1: [{ type: 'string', required: true }],
              2: [{ type: 'string', required: true }],
            },
          }],
        };

        ??數(shù)組的深層校驗(yàn),看起來比較傻,每個(gè)成員都要設(shè)置校驗(yàn)規(guī)則,對于動態(tài)數(shù)組,似乎也不知該如何設(shè)置。

        ??defaultField屬性,使我們對字段校驗(yàn)規(guī)則有了統(tǒng)一設(shè)置的手段。此屬性可以作用在校驗(yàn)屬性字段上,也可以作用在fields上。

        ??例如:

        rules : {
          urls: [{
            type: 'array',
            required: true,
            defaultField: { type: 'url' },
          }],
        };

        ??如果是對象數(shù)組,該如何設(shè)置?可如下方式:

        rules : {
          persons: [{
            type: 'array',
            required: true,
            defaultField:{
                type: 'object',
                required: true,
                fields: {
                    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' }],
                        },
                    }],
                    name: [{ type: 'string', required: true }],                  
                }
            }
          }],
        };

        ??數(shù)組套對象,對象套子對象,看起來有點(diǎn)復(fù)雜。

        4.3、動態(tài)規(guī)則集

        ??有時(shí)候不同模式進(jìn)入表單,需要應(yīng)用不同的規(guī)則。如新增和編輯操作,顯示同一個(gè)頁面組件。但此時(shí)對頁面需要校驗(yàn)的屬性字段有所不同,如何設(shè)置?

        ??有兩個(gè)處理方案。方案1是配置兩套規(guī)則集,根據(jù)不同模式進(jìn)行切換;方案2是配置總的規(guī)則集,根據(jù)不同模式抽取合適的屬性字段和規(guī)則,動態(tài)構(gòu)建規(guī)則集。

        4.3.1、切換校驗(yàn)規(guī)則集

        ??切換校驗(yàn)規(guī)則集,示例代碼如下:

          // data 部分
              // 當(dāng)前規(guī)則集
              rules:{},
              // 模式1規(guī)則集
              rules1:{
                 ...
              },
              // 模式2規(guī)則集
              rules2:{
                  ...
              },
        
              // methods部分
              // 動態(tài)切換
              // 頁面初始化
              init(obj,data){
                this.prevForm = obj;
        
                // 設(shè)置頁面可見
                this.visible = true;
        
                // DOM更新之后執(zhí)行
                this.$nextTick(()=>{
                  // 重置當(dāng)前頁面的所有字段值
                  this.$refs['form'].resetFields();
        
                  if (data){
                    // 模式1
                    this.form.patternType = 1;        
                  }else{
                    // 模式2
                    this.form.patternType = 2;
                  }        
                  // 設(shè)置校驗(yàn)規(guī)則
                  this.setValidRules(this.form.patternType);
                }
            },
              setValidRules(patternType){
                if(patternType == 1){
                    this.rules = this.rules1;
                }else if(patternType == 2){
                    this.rules = this.rules2;
                }
              },

        ??這樣,根據(jù)不同模式,切換了校驗(yàn)規(guī)則集。為了切換規(guī)則時(shí),立即執(zhí)行規(guī)則校驗(yàn),需要設(shè)置el-form的validate-on-rule-change為false,即:

        <el-form ref="form" :model="form" :rules="rules" 
                 :validate-on-rule-change=false 
                 class="useredit" label-width="100px" >
        4.3.2、動態(tài)構(gòu)建校驗(yàn)規(guī)則集

        ??動態(tài)構(gòu)建校驗(yàn)規(guī)則集,示例代碼如下:

          // data 部分
              // 當(dāng)前規(guī)則集
              rules:{},
              // 規(guī)則全集
              allRules:{
                  'formData.loginName': [
                    {required: true, message: "登錄名不能為空", trigger: 'blur'},
                    {validator:loginNameValidator, trigger: 'blur'}
                  ],
                  'formData.passwd': [
                    {required: true, message: "密碼不能為空", trigger: 'blur'},
                    {min: 6, max: 18, message: "密碼6-18位", trigger: 'blur'}
                  ],
                  'formData.email': [
                     {type: 'email', message: '需要符合email格式', trigger: 'blur'}
                  ],          
                  genderLabel: [
                    {required: true, message: "性別不能為空", trigger: 'change'},
                  ],
                  userTypeLabel : [
                    {required: true, message: "用戶類型不能為空", trigger: 'change'},
                  ],
                  deptLabel: [
                    {required: true, message: "部門不能為空", trigger: 'change'},
                  ]
              },
                  
              // methods部分
              // 動態(tài)切換
              // 頁面初始化
              init(obj,data){
                this.prevForm = obj;
        
                // 設(shè)置頁面可見
                this.visible = true;
        
                // DOM更新之后執(zhí)行
                this.$nextTick(()=>{
                  // 重置當(dāng)前頁面的所有字段值
                  this.$refs['form'].resetFields();
        
                  if (data){
                    // 模式1
                    this.form.patternType = 1;        
                  }else{
                    // 模式2
                    this.form.patternType = 2;
                  }        
                  // 設(shè)置校驗(yàn)規(guī)則
                  this.setValidRules(this.form.patternType);
                }
            },
              setValidRules(patternType){
                if (patternType == 1){
                  // 模式1
                  // 先清空,再設(shè)置          
                  this.rules = {};
                  this.rules['genderLabel'] = this.allRules['genderLabel'];
                  this.rules['userTypeLabel'] = this.allRules['userTypeLabel'];
                  this.rules['deptLabel'] = this.allRules['deptLabel'];
                  this.rules['formData.email'] = this.allRules['formData.email'];
                } else{
                  // 模式2,需要驗(yàn)證登錄名和密碼
                  this.rules = {};
                  this.rules['formData.loginName'] = this.allRules['formData.loginName'];
                  this.rules['formData.passwd'] = this.allRules['formData.passwd'];
                  this.rules['genderLabel'] = this.allRules['genderLabel'];
                  this.rules['userTypeLabel'] = this.allRules['userTypeLabel'];
                  this.rules['deptLabel'] = this.allRules['deptLabel'];
                  this.rules['formData.email'] = this.allRules['formData.email'];
                }
              },

        ??同樣也需要設(shè)置el-form的validate-on-rule-change為false。

        4.4、動態(tài)表格字段校驗(yàn)

        ??有的表單,使用了可編輯的動態(tài)表格,如添加一數(shù)據(jù)行,直接在數(shù)據(jù)行中輸入數(shù)據(jù),然后提交。此時(shí)需要對數(shù)據(jù)行各字段的輸入進(jìn)行校驗(yàn)。

        ??有2個(gè)方案。

        ??方案1使用Deep rules的defaultField,對對象數(shù)組進(jìn)行字段校驗(yàn),見上面的示例代碼。

        ??方案2,在el-form-item層級使用rules屬性綁定該字段規(guī)則。

        4.5、多字段聯(lián)合校驗(yàn)

        ??多字段聯(lián)合校驗(yàn)應(yīng)用場合還是比較常見的,如文本開始的問題,不同ID類型,有不同的校驗(yàn)規(guī)則;如密碼驗(yàn)證,兩次密碼要相同;如購買數(shù)量不能超過庫存數(shù)量,時(shí)間段開始時(shí)間要不大于結(jié)束時(shí)間,等等。

        ??關(guān)鍵技巧,利用校驗(yàn)器的第一個(gè)參數(shù)rule,添加一個(gè)或若干個(gè)自定義屬性,傳遞信息到校驗(yàn)器進(jìn)行處理。使用方法如下:

        ??作為示例,假設(shè)'formData.email'字段校驗(yàn)依賴于userType的值。

          'formData.email': [            
                     {validator : idFieldWithTypeValidator, trigger: 'blur',}
                  ],

        ??沒有辦法初始綁定:

          'formData.email': [            
                     {validator : idFieldWithTypeValidator, trigger: 'blur','userType':this.form.formData.userype}
                  ],

        ??這樣寫,瀏覽器調(diào)試器顯示錯(cuò)誤,提示調(diào)用resetFields出錯(cuò)。

        ??因此,正確的形式為:

          'formData.email': [            
                 {validator : idFieldWithTypeValidator, trigger: 'blur',}
              ],

        ??或:

          'formData.email': [            
                 {validator : idFieldWithTypeValidator, trigger: 'blur','userType':0}
              ],

        ??然后,在頁面初始化時(shí),或選擇框選擇改變的chage事件方法中,動態(tài)設(shè)置規(guī)則中userType屬性的值:

        this.rules['formData.email'][0]['userType'] = this.form.formData.userType;

        ??試驗(yàn)結(jié)果,用$set沒法動態(tài)綁定,即下列語句沒有作用:

        this.$set(this.allRules['formData.email'][0],'userType',this.form.formData.userType);

        ??好了,現(xiàn)在可以編寫一個(gè)聯(lián)合校驗(yàn)器idFieldWithTypeValidator了。簡單起見,在data部分編寫:

          const idFieldWithTypeValidator = (rule, value, callback) =>{
                // 獲取用戶類型
                console.log(rule);
                return callback();
              }

        ??測試一下,在瀏覽器控制臺輸出rule的打印信息如下:

        {
            "userType": 2,
            "field": "formData.email",
            "fullField": "formData.email",
            "type": "string"
        }

        ??此時(shí),userType已經(jīng)通過rule參數(shù)傳入,現(xiàn)在可以進(jìn)行聯(lián)合校驗(yàn)了。

          import {loginNameValidator,phoneNoValidator,idNoValidator,eMailValidator} from '@/common/validator.js'
          export default {
            data() {
              // 不同類型情況下的ID字段校驗(yàn)器
              const idFieldWithTypeValidator = (rule, value, callback) =>{
                // 獲取用戶類型
                console.log(rule);
                if (rule.userType == 1){
                  // 手機(jī)號碼
                  phoneNoValidator(rule, value, callback);
                }else if(rule.userType == 2){
                  // 身份證號碼
                  idNoValidator(rule, value, callback);
                }else if(rule.userType == 3){
                  // email
                  eMailValidator(rule, value, callback);
                }
              }
        
              return {
                  ....
              }            
            },
            ...
          }

        其中phoneNoValidator、idNoValidator、eMailValidator分別是手機(jī)號碼校驗(yàn)器、身份證號碼校驗(yàn)器、郵箱格式校驗(yàn)器,由validator.js中輸出,idFieldWithTypeValidator校驗(yàn)器根據(jù)userType參數(shù)的取值不同,分別調(diào)用了相關(guān)的validator類型的校驗(yàn)器。當(dāng)然,在idFieldWithTypeValidator的方法代碼中,也可以將各個(gè)校驗(yàn)器的代碼搬過來,不調(diào)用外部校驗(yàn)器。

        “Vue Element-ui如何實(shí)現(xiàn)表單校驗(yàn)規(guī)則”的內(nèi)容就介紹到這里了,感謝大家的閱讀。如果想了解更多行業(yè)相關(guān)的知識可以關(guān)注億速云網(wǎng)站,小編將為大家輸出更多高質(zhì)量的實(shí)用文章!

        向AI問一下細(xì)節(jié)

        免責(zé)聲明:本站發(fā)布的內(nèi)容(圖片、視頻和文字)以原創(chuàng)、轉(zhuǎn)載和分享為主,文章觀點(diǎn)不代表本網(wǎng)站立場,如果涉及侵權(quán)請聯(lián)系站長郵箱:is@yisu.com進(jìn)行舉報(bào),并提供相關(guān)證據(jù),一經(jīng)查實(shí),將立刻刪除涉嫌侵權(quán)內(nèi)容。

        AI