bootstrapvalidator之API學(xué)習(xí)教程
最近項(xiàng)目用到了bootstrap框架,其中前端用的校驗(yàn),采用的是bootstrapvalidator插件,也是非常強(qiáng)大的一款插件。我這里用的是0.5.2版本。
下面記錄一下使用中學(xué)習(xí)到的相關(guān)API,不定期更新。
1. 獲取validator對(duì)象或?qū)嵗?br />
一般使用校驗(yàn)是直接調(diào)用$(form).bootstrapValidator(options)來(lái)初始化validator。初始化后有兩種方式獲取validator對(duì)象或?qū)嵗?,可以用?lái)調(diào)用其對(duì)象的方法,比如調(diào)用resetForm來(lái)重置表單。有兩種方式獲取:
1)
// Get plugin instance var bootstrapValidator = $(form).data('bootstrapValidator'); // and then call method bootstrapValidator.methodName(parameters)
這種方式獲取的是BootstrapValidator的實(shí)例,可以直接調(diào)用其方法。
2)
$(form).bootstrapValidator(methodName, parameters);
這種方式獲取的是代表當(dāng)前form的jquery對(duì)象,調(diào)用方式是將方法名和參數(shù)分別傳入到bootstrapValidator方法中,可以鏈?zhǔn)秸{(diào)用。
兩種方式的使用分別如下:
// The first way $(form) .data('bootstrapValidator') .updateStatus('birthday', 'NOT_VALIDATED') .validateField('birthday'); // The second one $(form) .bootstrapValidator('updateStatus', 'birthday', 'NOT_VALIDATED') .bootstrapValidator('validateField', 'birthday');
2. defaultSubmit()
使用默認(rèn)的提交方式提交表單,調(diào)用此方法BootstrapValidator將不執(zhí)行任何的校驗(yàn)。一般需要時(shí)可以放在validator校驗(yàn)的submitHandler屬性里調(diào)用。
使用:
$('#defaultForm').bootstrapValidator({ fields: { username: { message: 'The username is not valid', validators: { notEmpty: { message: 'The username is required and can\'t be empty' } } } }, submitHandler: function(validator, form, submitButton) { // a) // Use Ajax to submit form data //$.post(form.attr('action'), form.serialize(), function(result) { // ... process the result ... //}, 'json'); //b) // Do your task // ... // Submit the form validator.defaultSubmit(); } });
3. disableSubmitButtons(boolean)
啟用或禁用提交按鈕。BootstrapValidator里默認(rèn)的提交按鈕是所有表單內(nèi)的type屬性值為submit的按鈕,即[type="submit"]。
使用:
當(dāng)?shù)卿浭r(shí),重新啟用提交按鈕。
$('#loginForm').bootstrapValidator({ message: 'This value is not valid', feedbackIcons: { valid: 'glyphicon glyphicon-ok', invalid: 'glyphicon glyphicon-remove', validating: 'glyphicon glyphicon-refresh' }, submitHandler: function(validator, form, submitButton) { $.post(form.attr('action'), form.serialize(), function(result) { // The result is a JSON formatted by your back-end // I assume the format is as following: // { // valid: true, // false if the account is not found // username: 'Username', // null if the account is not found // } if (result.valid == true || result.valid == 'true') { // You can reload the current location window.location.reload(); // Or use Javascript to update your page, such as showing the account name // $('#welcome').html('Hello ' + result.username); } else { // The account is not found // Show the errors $('#errors').html('The account is not found').removeClass('hide'); // Enable the submit buttons $('#loginForm').bootstrapValidator('disableSubmitButtons', false); } }, 'json'); }, fields: { username: { validators: { notEmpty: { message: 'The username is required' } } }, password: { validators: { notEmpty: { message: 'The password is required' } } } } });
4. enableFieldValidators(field, enabled)
啟用或禁用指定字段的所有校驗(yàn)。這里我的實(shí)
驗(yàn)結(jié)果是如果禁用了校驗(yàn),好像對(duì)應(yīng)的字段輸入(文本框、下拉等)也會(huì)變?yōu)榻谩?br />
使用:
當(dāng)密碼框不為空時(shí),開(kāi)啟密碼框和確認(rèn)密碼框的校驗(yàn):
// Enable the password/confirm password validators if the password is not empty $('#signupForm').find('[name="password"]').on('keyup', function() { var isEmpty = $(this).val() == ''; $('#signupForm').bootstrapValidator('enableFieldValidators', 'password', !isEmpty) .bootstrapValidator('enableFieldValidators', 'confirm_password', !isEmpty); if ($(this).val().length == 1) { $('#signupForm').bootstrapValidator('validateField', 'password') .bootstrapValidator('validateField', 'confirm_password'); } });
5. getFieldElements(field)根據(jù)指定的name獲取指定的元素,返回值是null或一個(gè)jQuery對(duì)象數(shù)組。
6. isValid()返回當(dāng)前需要驗(yàn)證的所有字段是否都合法。調(diào)用此方法前需先調(diào)用validate來(lái)進(jìn)行驗(yàn)證,validate方法可用在需要點(diǎn)擊按鈕或者鏈接而非提交對(duì)表單進(jìn)行校驗(yàn)的時(shí)候。使用:點(diǎn)擊某按鈕時(shí),提示所有字段是否通過(guò)校驗(yàn)。
$("#isAllValid").on("click", function(){ alert($("#defaultForm").data('bootstrapValidator').isValid()); });
7. resetForm(Boolean)
重置表單中設(shè)置過(guò)校驗(yàn)的內(nèi)容,將隱藏所有錯(cuò)誤提示和圖標(biāo)。
使用:
$("#isAllValid").on("click", function(){ alert($("#defaultForm").data('bootstrapValidator').isValid()); if(!$("#defaultForm").data('bootstrapValidator').isValid()) { $("#defaultForm").data('bootstrapValidator').resetForm(); } });
8. updateElementStatus($field, status, validatorName)
更新元素狀態(tài)。status的值有:NOT_VALIDATED, VALIDATING, INVALID or VALID。
9. updateStatus(field, status, validatorName)
更新指定的字段狀態(tài)。BootstrapValidator默認(rèn)在校驗(yàn)?zāi)硞€(gè)字段合法后不再重新校驗(yàn),當(dāng)調(diào)用其他插件或者方法可能會(huì)改變字段值時(shí),需要重新對(duì)該字段進(jìn)行校驗(yàn)。
使用:
點(diǎn)擊按鈕對(duì)文本框進(jìn)行賦值,并對(duì)其重新校驗(yàn):
$('#defaultForm').bootstrapValidator({ fields: { username: { message: 'The username is not valid', validators: { notEmpty: { message: 'The username is required and can\'t be empty' } } }, stringLength: { min: 6, max: 30, message: 'The username must be more than 6 and less than 30 characters long' } } }); $("#setname").on("click", function(){ $("input[name=username]").val('san'); var bootstrapValidator = $("#defaultForm").data('bootstrapValidator'); bootstrapValidator.updateStatus('username', 'NOT_VALIDATED').validateField('username'); //錯(cuò)誤提示信息變了 });
10. validate()
手動(dòng)對(duì)表單進(jìn)行校驗(yàn),validate方法可用在需要點(diǎn)擊按鈕或者鏈接而非提交對(duì)表單進(jìn)行校驗(yàn)的時(shí)候。
由第一條可知,調(diào)用方式同樣有兩種:
$(form).bootstrapValidator(options).bootstrapValidator('validate'); // or $(form).bootstrapValidator(options); $(form).data('bootstrapValidator').validate();
11. validateField(field)
對(duì)指定的字段進(jìn)行校驗(yàn)。
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
- JS組件Form表單驗(yàn)證神器BootstrapValidator
- 基于jQuery 實(shí)現(xiàn)bootstrapValidator下的全局驗(yàn)證
- 實(shí)用又漂亮的BootstrapValidator表單驗(yàn)證插件
- BootstrapValidator超詳細(xì)教程(推薦)
- Bootstrap中的表單驗(yàn)證插件bootstrapValidator使用方法整理(推薦)
- jquery插件bootstrapValidator數(shù)據(jù)驗(yàn)證詳解
- Bootstrapvalidator校驗(yàn)、校驗(yàn)清除重置的實(shí)現(xiàn)代碼(推薦)
- jquery插件bootstrapValidator表單驗(yàn)證詳解
- BootstrapValidator不觸發(fā)校驗(yàn)的實(shí)現(xiàn)代碼
- bootstrapValidator bootstrap-select驗(yàn)證不可用的解決辦法
相關(guān)文章
javascript實(shí)現(xiàn)去除HTML標(biāo)簽的方法
這篇文章主要介紹了javascript實(shí)現(xiàn)去除HTML標(biāo)簽的方法,涉及javascript正則替換相關(guān)操作技巧,需要的朋友可以參考下2016-12-12es6 super關(guān)鍵字的理解與應(yīng)用實(shí)例分析
這篇文章主要介紹了es6 super關(guān)鍵字的理解與應(yīng)用,結(jié)合實(shí)例形式分析了es6 super關(guān)鍵字的功能、原理、用法及相關(guān)操作注意事項(xiàng),需要的朋友可以參考下2020-02-02JS多次請(qǐng)求接口按順序依次執(zhí)行解決辦法
在JavaScript中for循環(huán)是同步的,意味著每個(gè)循環(huán)都會(huì)等待前一個(gè)循環(huán)的請(qǐng)求完成后才會(huì)執(zhí)行下一個(gè)循環(huán),這篇文章主要給大家介紹了關(guān)于JS多次請(qǐng)求接口按順序依次執(zhí)行的解決辦法,需要的朋友可以參考下2024-04-04實(shí)例解析ES6 Proxy使用場(chǎng)景介紹
本篇文章主要介紹了ES6 Proxy使用場(chǎng)景介紹,小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2018-01-01javascript游戲開(kāi)發(fā)之《三國(guó)志曹操傳》零部件開(kāi)發(fā)(一)讓靜態(tài)人物動(dòng)起來(lái)
首先來(lái)說(shuō),讓一個(gè)游戲賦有可玩性必須要?jiǎng)屿o結(jié)合,我將要在下面告訴大家如何運(yùn)用Javascript將靜態(tài)圖片變?yōu)閯?dòng)態(tài)圖片,感興趣的朋友可以了解下,便當(dāng)鞏固js知識(shí)了2013-01-01微信小程序仿知乎實(shí)現(xiàn)評(píng)論留言功能
這篇文章主要為大家詳細(xì)介紹了微信小程序仿知乎實(shí)現(xiàn)評(píng)論留言功能,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2018-11-11TextArea設(shè)置MaxLength屬性最大輸入值的js代碼
TextArea中限制最大輸入長(zhǎng)度,實(shí)現(xiàn)的方法種種,我們不在一一介紹,今天本文推薦一種簡(jiǎn)單實(shí)用的方法,需要的朋友可以參考下2012-12-12前端開(kāi)發(fā)不得不知的10個(gè)最佳ES6特性
ES6已經(jīng)不再是JavaScript最新的標(biāo)準(zhǔn),但是它已經(jīng)廣泛用于編程實(shí)踐中。下面通過(guò)本文給大家分享前端開(kāi)發(fā)不得不知的10個(gè)最佳ES6特性,感興趣的朋友參考下吧2017-08-08