DIV CSS 佈局教程網

jQuery 外掛 bootstrapValidator 表單驗證詳解
編輯:JQuery入門技巧     

Bootstrap Validator 是一款為 Bootstrap 3 設計的表單驗證 jQuery 外掛,非常適合基於 Bootstrap 框架的網站。作者已在 github 上宣布這款外掛不再更新,並推薦改用 FormValidation,但由於仍有不少專案在用,本文先介紹 BootstrapValidator 的用法。

準備工作

BootstrapValidator 文件地址:https://bv.doc.javake.cn/。下載原始碼後,把其中的 bootstrapValidator.min.css 與 bootstrapValidator.min.js 引入專案並在頁面中載入:

 <link rel="stylesheet" type="text/css" href="path/bootstrapValidator.min.css"> <script type="text/javascript" src="path/bootstrapValidator.min.js"></script> 

其中 path 是對應檔案的引入路徑。

簡單應用

文件中介紹的調用方法如下:

 $(document).ready(function() { $(formSelector).bootstrapValidator({ excluded: ..., feedbackIcons: ..., live: 'enabled', message: 'This value is not valid', submitButtons: 'button[type="submit"]', submitHandler: null, trigger: null, fields: { <fieldName>: { enabled: true, message: 'This value is not valid', container: null, selector: null, trigger: null, // Map the validator name with its options validators: { ... <validatorName>: <validatorOptions> ... } } ... } }); }); 

以下針對一個簡單的表單來說明:

 <form id="logForm" class="form-horizontal"> <div class="form-group"> <label class="col-lg-3 control-label">用戶名</label> <div class="col-lg-5"> <input type="text" class="form-control" name="username" /> </div> </div> <div class="form-group"> <label class="col-lg-3 control-label">郵箱</label> <div class="col-lg-5"> <input type="text" class="form-control" name="email" /> </div> </div> <div class="form-group"> <label class="col-lg-3 control-label">密碼</label> <div class="col-lg-5"> <input type="password" class="form-control" name="password" /> </div> </div> <button type="submit" class="btn btn-md">提交</button> </form> 

對這個表單套用 BootstrapValidator 很簡單:fieldName 對應表單中每一項的 name 屬性,而 BV 內建了許多 validator 供選用,郵箱格式驗證正是其中之一,不需要自己寫正則了。

 $(document).ready(function() { $('#signup-form').bootstrapValidator({ fields: { username: { validators: { notEmpty: { message: '用戶名不能為空' }, stringLength: { min: 3, max: 6, message: '用戶名只能在3-6個字符之間哦~' } } }, email: { validators: { emailAddress: { message: '郵箱格式有誤' } } }, password: { validators: { notEmpty: { message: '密碼不能為空' }, stringLength: { min: 6, max: 8, message: '密碼必須在6-8個字符之間~' }, regexp: { regexp: /^[a-zA-Z0-9]+$/, message: '密碼只能由字母、數字組成~' } } } } }); }); 

當不符合驗證要求時,會顯示對應的 message 提示,並禁用提交按鈕;提示資訊的顏色、字體等都能透過覆寫 CSS 來調整。效果如下:

註:圖中的註冊按鈕處於禁用狀態。

接著介紹 fields 的 selector。由於表單資料往往屬於某個註冊用戶,為了方便與後端進行資料交互,我們常會把 name 設成如下形式,這時就不能直接用 name 屬性驗證,而要改用 selector 來定義 fields:

 <form class="form-horizontal"> <div class="form-group"> <label class="col-lg-3 control-label">用戶名</label> <div class="col-lg-5"> <input type="text" id="user" class="form-control" name="login_user.userName" /> </div> </div> <div class="form-group"> <label class="col-lg-3 control-label">密碼</label> <div class="col-lg-5"> <input type="password" id="pass" class="form-control" name="login_user.password" /> </div> </div> <button type="submit" id="submitBtn" class="btn btn-md">提交</button> </form> 

對應的 JS 程式碼:

 $(document).ready(function() { $('#signup-form').bootstrapValidator({ fields: { user: { selector: '#user', validators: { notEmpty: { message: '用戶名不能為空' }, stringLength: { min: 3, max: 6, message: '用戶名只能在3-6個字符之間哦~' } } }, pass: { selector: '#pass', validators: { notEmpty: { message: '密碼不能為空' }, stringLength: { min: 6, max: 8, message: '密碼必須在6-8個字符之間~' }, regexp: { regexp: /^[a-zA-Z0-9]+$/, message: '密碼只能由字母、數字組成~' } } } } }); }); 

如果你嫌這樣寫過於累贅,也可以直接套用相應的 HTML 屬性,詳細可參考文件的 settings 部分。

以上只是 BootstrapValidator 的一個簡單應用,官方文件非常詳細,有興趣的話可繼續查閱,深入了解它強大的功能。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved