Build 0.8.4

dist/aspnet-validation.js

@@ -458,9 +458,31 @@ var ValidationService = /** @class */ (function () {
             var formUID = _this.getElementUID(form);
             var formValidationEvent = _this.elementEvents[formUID];
             if (formValidationEvent) {
-                formValidationEvent(null, callback);
+                formValidationEvent(undefined, callback);
             }
         };
+        /**
+         * Handler for validated form submit events.
+         * Default calls `submitValidForm(form)` on success
+         * and `focusFirstInvalid(form)` on failure.
+         * @param form The form that has been validated.
+         * @param success The validation result.
+         */
+        this.handleValidated = function (form, success) {
+            if (success) {
+                _this.submitValidForm(form);
+            }
+            else {
+                _this.focusFirstInvalid(form);
+            }
+        };
+        /**
+         * Calls `requestSubmit()` on the provided form.
+         * @param form The validated form to submit
+         */
+        this.submitValidForm = function (form) {
+            form.requestSubmit();
+        };
         /**
          * Focuses the first invalid element within the provided form
          * @param form
@@ -678,7 +700,7 @@ var ValidationService = /** @class */ (function () {
     ValidationService.prototype.getFormValidationTask = function (formUID) {
         var formInputUIDs = this.formInputs[formUID];
         if (!formInputUIDs || formInputUIDs.length === 0) {
-            return null;
+            return Promise.resolve(true);
         }
         var formValidators = [];
         for (var i = 0; i < formInputUIDs.length; i++) {
@@ -694,7 +716,7 @@ var ValidationService = /** @class */ (function () {
      */
     ValidationService.prototype.shouldValidate = function (e) {
         // Skip client-side validation if the form has been submitted via a button that has the "formnovalidate" attribute.
-        return !(e !== null && e['submitter'] && e['submitter']['formNoValidate']);
+        return !(e && e['submitter'] && e['submitter']['formNoValidate']);
     };
     /**
      * Tracks a <form> element as parent of an input UID. When the form is submitted, attempts to validate the said input asynchronously.
@@ -739,30 +761,15 @@ var ValidationService = /** @class */ (function () {
             _this.logger.log('Validating', form);
             validate.then(function (success) {
                 _this.logger.log('Validated (success = %s)', success, form);
-                var isProgrammaticValidate = !e;
-                if (success) {
-                    if (isProgrammaticValidate) {
-                        callback(true);
-                        return;
-                    }
-                    var validationEvent_1 = new CustomEvent('validation', {
-                        detail: { valid: true }
-                    });
-                    form.dispatchEvent(validationEvent_1);
-                    //Resubmit the form here, after the async validation is completed.
-                    form.requestSubmit();
+                if (callback) {
+                    callback(success);
                     return;
                 }
                 var validationEvent = new CustomEvent('validation', {
-                    detail: { valid: false }
+                    detail: { valid: success }
                 });
                 form.dispatchEvent(validationEvent);
-                if (isProgrammaticValidate) {
-                    callback(false);
-                }
-                else {
-                    _this.focusFirstInvalid(form);
-                }
+                _this.handleValidated(form, success);
             }).catch(function (error) {
                 _this.logger.log('Validation error', error);
             }).finally(function () {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "aspnet-client-validation",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "description": "Enables ASP.NET MVC client-side validation, without jQuery!",
   "main": "dist/aspnet-validation.js",
   "style": "dist/aspnet-validation.css",

types/index.d.ts

@@ -32,6 +32,10 @@ export declare type ValidationDirective = {
  * Promise return signifies asynchronous plugin behavior, with same behavior as Boolean or String.
  */
 export declare type ValidationProvider = (value: string, element: HTMLInputElement, params: StringKeyValuePair) => boolean | string | Promise<boolean | string>;
+/**
+ * Callback to receive the result of validating a form.
+ */
+export declare type ValidatedCallback = (success: boolean) => void;
 /**
  * Contains default implementations for ASP.NET Core MVC validation attributes.
  */
@@ -167,7 +171,20 @@ export declare class ValidationService {
      * @param form
      * @param callback
      */
-    validateForm: (form: HTMLFormElement, callback: Function) => void;
+    validateForm: (form: HTMLFormElement, callback?: ValidatedCallback) => void;
+    /**
+     * Handler for validated form submit events.
+     * Default calls `submitValidForm(form)` on success
+     * and `focusFirstInvalid(form)` on failure.
+     * @param form The form that has been validated.
+     * @param success The validation result.
+     */
+    handleValidated: (form: HTMLFormElement, success: boolean) => void;
+    /**
+     * Calls `requestSubmit()` on the provided form.
+     * @param form The validated form to submit
+     */
+    submitValidForm: (form: HTMLFormElement) => void;
     /**
      * Focuses the first invalid element within the provided form
      * @param form
@@ -180,15 +197,15 @@ export declare class ValidationService {
      * @param callback
      * @returns
      */
-    isValid: (form: HTMLFormElement, prevalidate: boolean, callback: Function) => boolean;
+    isValid: (form: HTMLFormElement, prevalidate?: boolean, callback?: ValidatedCallback) => boolean;
     /**
      * Returns true if the provided field is valid, and then calls the callback. The form will be validated before checking, unless prevalidate is set to false
      * @param form
      * @param prevalidate
      * @param callback
      * @returns
      */
-    isFieldValid: (field: HTMLElement, prevalidate: boolean, callback: Function) => boolean;
+    isFieldValid: (field: HTMLElement, prevalidate?: boolean, callback?: ValidatedCallback) => boolean;
     /**
      * Returns true if the event triggering the form submission indicates we should validate the form.
      * @param e