Remote validator.

README.md

@@ -123,7 +123,6 @@ For integrating with Twitter bootstrap 3 (horizontal form), this is what you nee
     });
 
     var bootstrapField = function (name, object) {
-
         object.widget.classes = object.widget.classes || [];
         object.widget.classes.push('form-control');
 
@@ -217,6 +216,23 @@ Forms can be created with an optional "options" object as well.
 * `validatePastFirstError`: `true`, otherwise assumes `false`
  * If `false`, the first validation error will halt form validation.
  * If `true`, all fields will be validated.
+* `remoteValidator`: function that returns an object of validation, eg by making the http request. If it is defined fields validation will be ignored. An example:
+
+    ```
+    var remoteValidator = function(data, next) {
+            var response = {
+                field1: {
+                    error: 'validation error 1',
+                    value: 'wrongInput1'
+                },
+                field2: {
+                    error: 'validation error 2',
+                    value: 'wrongInput2'
+                }
+            };
+            next(response);
+        }
+    ```
 
 
 ### Form object

lib/fields.js

@@ -187,4 +187,3 @@ exports.date = function (opt) {
 exports.object = function (fields, opts) {
     return forms.create(fields || {});
 };
-

lib/forms.js

@@ -32,6 +32,8 @@ exports.create = function (fields, opts) {
             var b = {};
             b.toHTML = f.toHTML;
             b.fields = {};
+            b.remoteValidator = f.remoteValidator;
+
             Object.keys(f.fields).forEach(function (k) {
                 if (data != null) {
                     b.fields[k] = f.fields[k].bind(data[k]);
@@ -47,6 +49,20 @@ exports.create = function (fields, opts) {
                     callback = arguments[0];
                 }
 
+                if(b.remoteValidator) {
+                    b.remoteValidator(b.data, (function(b) {
+                        return function (err, response) {
+                            var form = b;
+                            Object.keys(form.fields).forEach(function (fieldName) {
+                                    form.fields[fieldName].error = response[fieldName].error;
+                                    form.fields[fieldName].value = response[fieldName].value;
+                            });
+                            callback(err, form);
+                        };
+                    })(b));
+                    return;
+                }
+
                 async.forEach(Object.keys(b.fields), function (k, callback) {
                     b.fields[k].validate(b, function (err, bound_field) {
                         b.fields[k] = bound_field;
@@ -111,8 +127,8 @@ exports.create = function (fields, opts) {
                 var kname = is.string(name) ? name + '[' + k + ']' : k;
                 return html + form.fields[k].toHTML(kname, iterator);
             }, '');
-        }
+        },
+        remoteValidator: opts.remoteValidator
     };
     return f;
 };
-

test/test-form.js

@@ -151,6 +151,96 @@ test('validate invalid data', function (t) {
     });
 });
 
+test('validate valid data with remote validator', function (t) {
+    t.plan(2);
+    var fields = {
+        field1: forms.fields.string(),
+        field2: forms.fields.string()
+    };
+
+    var options = {
+        remoteValidator: function(data, next) {
+            setTimeout(function() {
+                var response = {
+                    field1: {
+                        error: '',
+                        value: 'field1 value'
+                    },
+                    field2: {
+                        error: '',
+                        value: 'field2 value'
+                    }
+                };
+                next(null, response);
+            }, 100);
+        }
+    };
+
+    var f = forms.create(fields, options);
+
+    f.bind({field1: '1', field2: '2'}).validate(function (err, f) {
+        t.equal(f.isValid(), false);
+        t.equal(
+            f.toHTML(),
+            '<div class="field">' +
+                '<label for="id_field1">Field1</label>' +
+                '<input type="text" name="field1" id="id_field1" value="field1 value" />' +
+            '</div>' +
+            '<div class="field">' +
+                '<label for="id_field2">Field2</label>' +
+                '<input type="text" name="field2" id="id_field2" value="field2 value" />' +
+            '</div>'
+        );
+        t.end();
+    });
+});
+
+test('validate invalid data with remote validator', function (t) {
+    t.plan(2);
+    var fields = {
+        field1: forms.fields.string(),
+        field2: forms.fields.string()
+    };
+
+    var options = {
+        remoteValidator: function(data, next) {
+            setTimeout(function() {
+                var response = {
+                    field1: {
+                        error: 'validation error 1',
+                        value: 'wrongInput1'
+                    },
+                    field2: {
+                        error: 'validation error 2',
+                        value: 'wrongInput2'
+                    }
+                };
+                next(null, response);
+            }, 100);
+        }
+    };
+
+    var f = forms.create(fields, options);
+
+    f.bind({field1: '1', field2: '2'}).validate(function (err, f) {
+        t.equal(f.isValid(), false);
+        t.equal(
+            f.toHTML(),
+            '<div class="field error">' +
+                '<p class="error_msg">validation error 1</p>' +
+                '<label for="id_field1">Field1</label>' +
+                '<input type="text" name="field1" id="id_field1" value="wrongInput1" />' +
+            '</div>' +
+            '<div class="field error">' +
+                '<p class="error_msg">validation error 2</p>' +
+                '<label for="id_field2">Field2</label>' +
+                '<input type="text" name="field2" id="id_field2" value="wrongInput2" />' +
+            '</div>'
+        );
+        t.end();
+    });
+});
+
 test('handle empty', function (t) {
     t.plan(3);
     var f = forms.create({field1: forms.fields.string()});
@@ -444,4 +534,3 @@ test('div bound error', function (t) {
         t.end();
     });
 });
-