@degjs/form-validation-pattern
v2.0.0
Published
A pattern rule for the DEGJS formValidation module.
Downloads
7
Readme
formValidation-pattern
A pattern rule module for the DEGJS formValidation module.
Install
formValidation-pattern is an ES6 module. Consequently, you'll need an ES6 transpiler (Babel is a nice one) as part of your Javascript workflow.
If you're already using NPM for your project, you can install formValidation-pattern with the following command:
$ npm install @degjs/form-validation-pattern
Usage
After importing, formValidation rule modules can be instantiated by passing an array of names into a formValidation options object:
import formValidation from "@degjs/form-validation";
/* Import the Pattern rule module */
import pattern from "@degjs/form-validation-pattern";
let validationOptions = {
rules: [
pattern
]
};
/* Instantiate the formValidation module on an element */
let formElement = document.querySelector('.form');
let validationInst = formValidation(formElement, validationOptions);
Optionally, default rule settings can be overridden by instantiating the rule as a function and passing options as an object:
let validationOptions = {
rules: [
pattern({
message: 'This message will override the default rule message.',
events: [
'focusout',
'submit'
]
})
]
};
formValidation-pattern builds upon the HTML5 pattern
validation pattern. Therefore, after instantiating the rule module, a field in the validation instance will be tested by this rule simply by adding a pattern
attribute to the field input.
This rule module contains its own default validation message. However, this message can be overridden by adding a data attribute at the field or form level (in that order of importance).
Sample Markup:
<form class="form" data-validation-pattern-message="This message will override the default rule message.">
<fieldset>
<div class="js-validation-field" data-validation-pattern-message="This message will override both the default rule message and the form element message.">
<label for="country">Three-letter Country Code</label>
<input type="text" pattern="[A-Za-z]{3}" id="country" name="country">
</div>
<button type="submit">Submit</button>
</fieldset>
</form>
Options
options.message
Type: String
Default: Please match the field format.
The default message displayed when a field fails this rule's validation test.
options.messageAttr
Type: String
Default: data-validation-pattern-message
The data attribute formValidation will check when determining message hierarchy
options.events
Type: Array
Default: ['focusout','submit']
An array of DOM events that will cause the rule to run validation on a field (or the entire form, when using submit
). NOTE: focusout
should be used in place of blur
due to event bubbling limitations.
For more detailed usage instructions, see the formValidation Usage documentation.