News

New features

• #109: Add prevalidate.form.fv event that is triggered before validating the form

Improvements

• #92: Improve Dutch national identification number (BSN) validator. It doesn't accept numbers which have less than 8 digits
• #99: Add the date to return value of the date validator. We can reuse it for additional job
• #130: The remote validator supports using $field and value in data/url callbacks
• The isbn validator adds ISBN type to the return value
• The ismn validator adds ISMN type to the return value

Bug fixes

• #102: Fix an issue on IE 10/11 that causes an input element with placeholder attribute to be validated automatically when it's focused
• #148: Fix an issue that causes the validating icon to not shown when the field is being validated

Document

• #104: Add Supporting multiple MIME types section
• #110: Add Validating start and end date/times example
• #116: Fix exclude option typo in the wizard examples
• #123: Add Validating credit card expiration date example
• Add Adding fields with different names example
• Add Asking credit card number to match with selected type example
• Add Getting notified while field is being validated example
• Add Ignoring validation example
• Add Playing with selectize example
• Add Supporting Skeleton framework example
• Fix numreic typo in the phone validator
• Update the err.container option and the Showing messages in custom area example
• Update the Modifying the value before validating example

Download

Highlight

• Add new promise validator
• Add STATUS_IGNORED status. The field will be ignored for the current validation if the validator returns null

New features

• iban validator adds new sepa option that requires the IBAN number must be (or not) from the SEPA countries
• iban validator now supports East Timor, Kosovo countries

Improvements

• date validator supports dot (.) separator for European countries
• #57, #82: iban validator will return false if the country is not supported
• #62: Allow to use callback for field's excluded option
• #91: Skip validation on button using formnovalidate attribute
• Add more examples for iban test suite
• The field container and its feedback icon don't have success/error class if all field validators are disabled

Bug fixes

• #47: Spanish VAT validator doesn't work with some examples
• #48: Override the options when adding field
• #50: The Brazilian ID (CPF) number must have 11 digits
• The updateMessage() method must return the plugin instance for chaining
• When calling resetField(true) and resetForm(true) methods, the field need be reset value before updating the status

Document

• #38: Add Loading and saving data in a modal example
• #43: Add Playing with Bootstrap Combobox example
• #45: Update the Showing card icon example
• #49: Add Switching validators on the same field example
• #54: Add Playing with geocomplete example
• #61: Add Validating fields that depend on each other example
• #71: Add Skip validation on specific submit button example
• #86: Update the summernote example that uses the latest version of Summernote
• #88: Add Can't submit form after validation example
• Add Conditional validation example
• Add Modifying the value before validating example
• Add Playing with Fuel UX example
• Add Using data returned by validator example
• Add Using multiple buttons example
• Add Using tooltip to show message example
• Add Validating array of inputs example
• Fix the Clearing field when clicking the icon example
• Fix the validator event description
• Fix various links in the Bootstrap modal example
• Update the Ajax example, adding a section showing how to upload files with FormData
• Update the iCheck example to support mobile browsers

Download

Highlight

• #467: Add dataType, crossDomain, validKey options for remote validator.

It's possible to use remote validator to connect to external validator API, such as MailGun (#1315).

• #1357: In addition to Bootstrap, Foundation, Pure, Semantic, UIKit, v0.6.1 provides the ability of supporting custom framework

New features

• #940: Add declarative option to support big form
• #1328, #1330: Add Netherlands phone validator, thanks to @HendrikSwBase
• #1347: Add Bulgarian zip code validator, thanks to @Izopi4a
• #1350: Add Bulgarian phone number validator, thanks to @Izopi4a
• #1355: Add Polish zip code and id validators, thanks to @tjagusz

Improvements

• #1327: remote validator fails if Ajax request fails
• #1427: Update Netherlands phone number validator, thanks to @DiederikLascaris
• Add plugin instance to the 3rd parameter of transformer callback
• Add Grunt task that runs the jasmine test suites

Bug fixes

This version fixed the isValid() method which should return null when there is not validated or being validated field. It also solves the issues where the submit button is disabled even when the form is valid.

• #962, #1318: remote validator and isValid() combined do not work
• #1160: Submit button is disabled
• #1171: Submit button being disabled
• #1220: Can only submit form after changing a value
• #1221, #1344: Remote validation trigger err.form.fv
• #1394: Submit incorrectly enabled even though form has errors

Other issues are fixed in this version:

• #1107, #1279, #1280, #1419: Show the validating icon when the field is being validated
• #1282: Reset checkbox when calling resetForm() method
• #1320: Fix Slovakia phone number validator
• #1343, #1369: Fix the issue where custom validator doesn't provide default message
• #1379: Don't continue if there is no validators attached to fields
• #1387: transformer option doesn't work with notEmpty validator
• #1389: Fix isValidContainer() and validateContainer() methods to support fields with the same name

Document

• #673: Update emailAddress validator document
• #688: Add a notice when using FontAwesome icon
• #973, #1021, #1346: 3 ways to improve performance when using remote validator
• #1098, #1118, #1325: Add Playing with Fuel UX Wizard example
• #1109, #1326: Add Playing with Typehead example
• #1112: Support thousand separator
• #1124, #1329: Fix CKEditor example on Firefox
• #1205: Add Playing with Bootstrap Material Design example
• #1308: Update Showing card icon example
• #1313: Add Adding warning validation state example
• #1315: Add Using Mailgun API to validate email address example
• #1333: Update Enabling the submit button example
• #1378: Add Validating multiple inputs as one example
• #1388: Add Field value is changed programmatically example
• #1390: Fix the isValid() method document
• #1397: Add Updating validator options example
• #1423: Update the UIKit icon usage
• Fix the issue in Settings Structure section, thanks to @DiederikLascaris
• #29: Add Playing with jQuery UI Datepicker example
• #33: Add Playing with Flat UI example
• #37: Add Showing all messages when using callback validator example

Language packages

• #1381: Update Slovak language package, thanks to @PatrikGallik
• #1400: Update Belgian Dutch language package, thanks to @jdt
• #1432: Fix some typos in the Hungarian translation, thanks to @blackfyre

Download

From v0.6.0, the plugin name is changed to FormValidation. To upgrade from v0.5.3 to v0.6.0, perform the following steps:

Required Step: Changing CSS, Javascript paths

This step is required.

<!-- Path to Bootstrap CSS v3.0.0 or higher -->
<link rel="stylesheet" href="/vendor/bootstrap/css/bootstrap.min.css">

<!-- Path to BootstrapValidator CSS -->
<link rel="stylesheet" href="/vendor/bootstrapvalidator/dist/css/bootstrapValidator(.min).css">

<!-- jQuery v1.9.1 or higher -->
<script type="text/javascript" src="/vendor/jquery/jquery.min.js"></script>

<!-- Path to Bootstrap JS -->
<script src="/vendor/bootstrap/js/bootstrap.min.js"></script>

<!-- Path to BootstrapValidator JS -->
<script type="text/javascript" src="/vendor/bootstrapvalidator/dist/js/bootstrapValidator(.min).js"></script>

<!-- Path to Bootstrap CSS v3.0.0 or higher -->
<link rel="stylesheet" href="/vendor/bootstrap/css/bootstrap.min.css">

<!-- FormValidation CSS file -->
<link rel="stylesheet" href="/vendor/formvalidation/dist/css/formValidation(.min).css">

<!-- jQuery v1.9.1 or higher -->
<script type="text/javascript" src="/vendor/jquery/jquery.min.js"></script>

<!-- Path to Bootstrap JS -->
<script src="/vendor/bootstrap/js/bootstrap.min.js"></script>

<!-- FormValidation plugin and the class supports validating Bootstrap form -->
<script src="/vendor/formvalidation/dist/js/formValidation(.min).js"></script>
<script src="/vendor/formvalidation/dist/js/framework/bootstrap(.min).js"></script>

Required Step: Changing your own validator

You can ignore this step in case you don't have any your own validators. Otherwise, change its declaration as following:

(function($) {
    $.fn.bootstrapValidator.validators.yourValidatorName = {
        validate: function(validator, $field, options) {
            ...
        }
    };
}(window.jQuery));

(function($) {
    FormValidation.Validator.yourValidatorName = {
        validate: function(validator, $field, options) {
            // ...
            // The validation code is the same
        }
    };
}(window.jQuery));

Optional Step: Calling plugin

After completing the steps above, you can call the plugin by both programmatic and declarative usages as before.

Using v0.5.3 options as your current one are supported in all v0.6.x releases. It means that you will have a lot of time to upgrade your code while current one still work.

Anyway, it is recommended to change the plugin calling, options which are listed as following:

Attribute

Form settings

$(form).bootstrapValidator({
    container: 'tooltip',
    feedbackIcons: {
        valid: '...',
        invalid: '...',
        validating: '...'
    },
    group: 'td',
    submitButtons: '#submitButton'
});

$(form).formValidation({
    framework: 'bootstrap',
    err: {
        container: 'tooltip'
    }
    icon: {
        valid: '...',
        invalid: '...',
        validating: '...'
    },
    row: {
        selector: 'td'
    },
    button: {
        selector: '#submitButton'
    }
});

Field settings

$(form).bootstrapValidator({
    fields: {
        fieldName: {
            container: 'tooltip',
            feedbackIcons: false,
            group: '.col-sm-3',
            validators: {
                ...
            }
        }
    }
});

$(form).formValidation({
    framework: 'bootstrap',
    fields: {
        fieldName: {
            err: 'tooltip',
            icon: false,
            row: '.col-sm-3',
            validators: {
                ...
            }
        }
    }
});

Events

There are two changes about the event names:

• The namespace .bv is changed to .fv
• The namespace error. is changed to err. to avoid window.onerror being invoked by jQuery

The last thing, the hexColor validator, deprecated in v0.5.3, is replaced with color validator.

New name

From v0.6.0, the plugin has new name: FormValidation. It supports validating form created by many frameworks including

• Bootstrap
• Foundation
• Pure
• Semantic UI
• UIKit

Highlight

• #744: Add transformer option, allowing to hook the value of field before validating
• #1131: Support add-on
• #1204: Support Zurb Foundation framework
• #1210: Support UI Kit framework
• #1211: Support Semantic UI framework
• #1212: Support Pure framework

New features

• #708, #899: Add setLocale() and getLocale() methods to support multiple languages
• #718: Add validateContainer() method
• #1140: Add UAE phone number validator, thanks to @s-a-y
• #1153: Add EIN validator, thanks to @joshuachestang
• #1165: Add BIC (ISO 9362) validator, thanks to @thomaslhotta
• #1185: Add composer.json file, thanks to @rbnvrw
• #1189, #1194: Add err, icon, row options
• #1207: Add Spanish postal code validator, thanks to @ethernet-zero
• #1208: Support Spanish CIF validator, thanks to @ethernet-zero
• #1227, #1229: Add India phone number validator, thanks to @waveking
• #1230, #1231: Add India postal code validator, thanks to @waveking

Changes

• #1167: Remove hexColor validator. Use color validator instead
• #1272: Change event error.x.x to err.x.x to avoid window.onerror being invoked by jQuery
• Remove tab behavior from base class

Improvements

• #883: Look for the field inside form first when using selector, thanks to @drebrez
• #908, #1156: Add allowEmptyProtocol option to set optional protocol in uri validator, thanks to @krecik
• #914, #1035, #1163: Improve identical validator, thanks to @jazzzz
• #1037: Show the credit card icon based on its type
• #1083, #1092: Showing tooltip/popover when moving over or clicking the feedback icon (Bootstrap 3.3.0), thanks to @Arkni
• #1137: Use jQuery instead of window.jQuery
• #1154: Allow to reuse data which is returned by the validator
• #1177: Don't need to set the different validator for both fields
• #1186, #1188: Improve the CPF validator, thanks to @igorescobar
• #1197: Add sample data for CPF validator, thanks to @dgmike
• #1207: Improve Spanish phone validator, thanks to @ethernet-zero
• #1218: Improve Slovenian vat number validator, thanks to @Glavic
• #1224: Improve tooltip style when working with Semantic UI form, thanks to @Arkni
• #1226: Fix destroying Semantic UI popup, thanks to @Arkni
• #1239: Fix typo in UIKit class, thanks to @Arkni
• #1252: Validators return true for not supported countries
• #1255, #1258: Support to use a Date object as value for min and max options, thanks to @Arkni
• #1261: Improve cvv validator
• #1268: uri validator gets slower if more than 25 characters
• The isValidContainer() method should return null if the container consists of at least one field which is not validated yet or being validated

Bug fixes

• #1101: The cusip validator doesn't work
• #1102: Fix the date validator issue where accepts 2014-11-1 23: as valid YYYY-MM-DD h:m date
• #1105: The color validator doesn't provide html5Attributes mapping
• #1125, #1136: Update Brazil ID validator to support working with Mask plugin, thanks to @jonasesteves
• #1243: Fix the icon without label class
• #1267: identical validator allows to compare with any input
• #1274: Fix validateContainer() to use map value instead of key, thanks to @jasonblalock
• #1279, #1280: Show the validating icon when the field is being validated, thanks to @tmaly1980
• #1292: Fix bug of US phone number validator

Document

• #800: Add Using uri and regexp validators example
• #825: Add Bootstrap Datepicker example
• #919, #1114: Add Google reCAPTCHA example
• #941: Add Clearing field when clicking the icon example
• #948, #978, #1032, #1146, #1162: Add the Is a@b valid email address section
• #1034: Add Only enable the submit button if all fields are valid example
• #1078, #1104: Update the Enabling the submit button all the time example
• #1106: Add example to the phone validator
• #1122: Add third parameter to callback method of callback validator, thanks to @Arkni
• #1128: Add link to the Examples from the homepage
• #1139: Add sample United Arab Emirates phone numbers, thanks to @s-a-y
• #1143, #1176: Add Form is submitted twice example
• #1172: Add Requiring at least one field example
• #1174: Add Pickadate example
• #1187: Add sample Brazil ID (CPF) numbers, thanks to @igorescobar
• #1233: Add sample India postal code numbers, thanks to @waveking

Language packages

• #1150: Add Catalan language package, thanks to @ArnauAregall
• #1216, #1248: Add Slovak language package, thanks to @budik21
• #1217, #1247: Update Czech language package, thanks to @budik21
• #1225: Add Finnish language package, thanks to @traone
• #1246: Add Hindi language package, thanks to @gladiatorAsh
• #1321: Add Basque language package, thanks to @xabikip

Contributors

Thanks to contributors:

• @Arkni
• @ArnauAregall
• @budik21
• @dgmike
• @drebrez
• @ethernet-zero
• @gladiatorAsh
• @Glavic
• @igorescobar
• @jasonblalock
• @jazzzz
• @jonasesteves
• @joshuachestang
• @krecik
• @rbnvrw
• @s-a-y
• @thomaslhotta
• @tmaly1980
• @traone
• @xabikip
• @waveking

Download