denkwerk validation service

• ValidationService (the basic validation service class)
• ValidationServiceDom (extends ValidationService class and adds basic dom handling)
• FormValidation (a full customizable html configurable form validation adaption)

• The documentation can be found in "dist/esdoc", just download a release:
  https://github.com/denkstrap/denkstrap-toolkit/releases

Download formValidation.js, located in folder "dist/validation/" and embed it.
Dist folder is shipped with each release:
https://github.com/denkstrap/denkstrap-toolkit/releases

Use "data-validation" attribute to define a validation field in the markup.
The according form needs an id. This id is the minimal option to give to the form validation class constructor. Each field needs a specific id, too.
Example:

<form id="form">
    <label for="name">Name</label>
    <input name="name" id="name" data-validation='{
    "validators": {
    "required": {"message": "Enter your name, please."}
    }
    }'>
    <button type="submit>Submit</button>
</form>

<script>
    var validationService = new FormValidation( { formId: 'form'} );

    var form = document.getElementById( form );
    form.addEventListener( 'submit', function( event ) {
        event.preventDefault();
        validationService.validateForm().then( function( result ) {
           form.submit();
        } ).catch( function( result ) {
            console.log( '----->validateForm fail', result );
        } );
    } );
</script>

You have to include the according polyfills in folder "demo/polyfills" to make it running in all tested browsers (IE10, Android 5, Chrome, Safari, Firefox).

Have a look on the docs and demo page for further options and examples.

There are a few prerequisites for this repository:

• nvm on Mac and Linux, nvmw or nvm-windows on Windows
• As an alternative you have node.js version 6.0 as your systems default node.js version (Version 6.0 of node is necessary to run ESDoc.)

yarn install

Sources are located here: "src/". The code is written in ES6. It's transpiled to ES2015 via Babbel.

Tests are located here; "test/".
Test files must have same file name as source files plus ".spec" extension.
Tests are written with Jasmine and Sinon.JS.
The tests ara running in Karma.
Karma tests can run in real browsers.
Some browser adapters are installed. Comment them out/in in the "karma.conf.js" to let the tests run with the target browser (The browser must be installed on your system locally).

• yarn run watch (runs the watch task)
• yarn run test (runs the karma tests
• yarn lint-fix (runs ESLint with auto-error-fixing)
• yarn doc (runs ESDoc)

Code coverage ist build within test task. Coverage output is located in folder "artifacts/test/coverage".