Now possible to validate file size, extension and type using the file module

Author: victorjonsson

README.md

@@ -74,7 +74,7 @@ Read the documentation for the default features at [http://formvalidator.net/#de
  * **spamcheck**
  * **confirmation**
  * **strength** — *Validate the strength of a password (strength strength3)*
- * **backend** — *Validate value of input on backend*
+ * **backend** — *Validate value of input on server side*
 
 Read the documentation for the security module at [http://formvalidator.net/#security-validators](http://formvalidator.net/#security-validators)
 
@@ -93,6 +93,13 @@ Read the documentation for the date module at [http://formvalidator.net/#date-va
 
 Read the documentation for the location module at [http://formvalidator.net/#location-validators](http://formvalidator.net/#location-validators)
 
+### Module: file
+ * **mime**
+ * **extension**
+ * **size**
+
+Read the documentation for the file module at [http://formvalidator.net/#file-validators](http://formvalidator.net/#file-validators)
+
 ### Module: sweden
  * **swemob** — *validate that the value is a swedish mobile telephone number*
  * **swesec** — *validate swedish social security number*
@@ -227,14 +234,18 @@ var enErrorDialogs = {
     badLength : 'You have to give an answer between ',
     notConfirmed : 'Values could not be confirmed',
     badDomain : 'Incorrect domain value',
-    badUrl : 'Incorrect url value',
-    badFloat : 'Incorrect float value',
+    badUrl : 'The answer you gave was not a correct URL',
     badCustomVal : 'You gave an incorrect answer',
-    badInt : 'Incorrect integer value',
+    badInt : 'The answer you gave was not a correct number',
     badSecurityNumber : 'Your social security number was incorrect',
     badUKVatAnswer : 'Incorrect UK VAT Number',
+    badStrength : 'The password isn\'t strong enough',
     badNumberOfSelectedOptionsStart : 'You have to choose at least ',
-    badNumberOfSelectedOptionsEnd : ' answers'
+    badNumberOfSelectedOptionsEnd : ' answers',
+    badAlphaNumeric : 'The answer you gave must contain only alphanumeric characters ',
+    badAlphaNumericExtra: ' and ',
+    wrongFileSize : 'The file you are trying to upload is too large',
+    wrongFileType : 'The file you are trying to upload is of wrong type'
 };
 ```
 
@@ -269,6 +280,9 @@ that attribute will be displayed instead of the error dialog that the validation
 
 ## Changelog
 
+#### 2.0.7
+ * Now possible to validate file size, extension and mime type (using the file module)
+
 #### 2.0
  * [min|max]_length is removed (now merged with length validation).
  * The number, int and float validation is merged together, all three variants is now validated by the number validation.

form-validator/date.dev.js

@@ -4,23 +4,21 @@
  * Created by Victor Jonsson <http://www.victorjonsson.se>
  * Documentation and issue tracking on Github <https://github.com/victorjonsson/jQuery-Form-Validator/>
  *
- * This form validation module adds validators used to validate date
- * and time values. The following validators will be added by
- * this module:
- *  - validate_time
- *  - validate_birthdate
- *
+ * The following validators will be added by this module:
+ *  - Time (HH:mmm)
+ *  - Birth date
  *
+ * @website http://formvalidator.net/#location-validators
  * @license Dual licensed under the MIT or GPL Version 2 licenses
- * @version 2.0.3
+ * @version 2.0.7
  */
 (function($) {
 
     /*
      * Validate time hh:mm
      */
     $.formUtils.addValidator({
-        name : 'validate_time',
+        name : 'time',
         validate : function(time) {
             if (time.match(/^(\d{2}):(\d{2})$/) === null) {
                 return false;
@@ -41,7 +39,7 @@
      * Is this a valid birth date
      */
     $.formUtils.addValidator({
-        name : 'validate_birthdate',
+        name : 'birthdate',
         validate : function(val, $el, conf) {
             var dateFormat = 'yyyy-mm-dd';
             if($el.valAttr('format')) {

form-validator/date.js

@@ -0,0 +1,135 @@
+/**
+ * jQuery Form Validator Module: File
+ * ------------------------------------------
+ * Created by Victor Jonsson <http://www.victorjonsson.se>
+ *
+ * The following validators will be added by this module:
+ *  - mime type
+ *  - file size
+ *  - file extension
+ *
+ * @website http://formvalidator.net/
+ * @license Dual licensed under the MIT or GPL Version 2 licenses
+ * @version 2.0.7
+ */
+(function($, window) {
+
+    var SUPPORTS_FILE_READER = typeof window.FileReader != 'undefined',
+
+        /**
+         * @return {Array}
+         */
+        _getTypes = function($input) {
+            var allowedTypes = $.split( ($input.valAttr('allowing') || '').toLowerCase() );
+
+            if( $.inArray('jpg', allowedTypes) > -1 && $.inArray('jpeg', allowedTypes) == -1)
+                allowedTypes.push('jpeg');
+            else if( $.inArray('jpeg', allowedTypes) > -1 && $.inArray('jpg', allowedTypes) == -1)
+                allowedTypes.push('jpg');
+            return allowedTypes;
+        };
+
+    /*
+     * Validate mime type (falls back on validate_extension in older browsers)
+     */
+    $.formUtils.addValidator({
+        name : 'mime',
+        validate : function(str, $input) {
+            var files = $input.get(0).files || [];
+
+            if( SUPPORTS_FILE_READER ) {
+                var valid = true,
+                    mime = '',
+                    allowedTypes = _getTypes($input);
+
+                $.each(files, function(i, file) {
+                    valid = false;
+                    mime = file.type || '';
+                    $.each(allowedTypes, function(j, type) {
+                        valid = mime.indexOf(type) > -1;
+                        if( valid ) {
+                            return false;
+                        }
+                    });
+                    return valid;
+                });
+                return valid;
+
+            } else {
+                return $.formUtils.validators.extension.validate(str, $input);
+            }
+        },
+        errorMessage : 'The file you are trying to upload is of wrong type',
+        errorMessageKey: 'wrongFileType'
+    });
+
+    /**
+     * Validate file extension
+     */
+    $.formUtils.addValidator({
+        name : 'extension',
+        validate : function(val, $input) {
+            var ext = val.substr( val.lastIndexOf('.')+1 );
+            return $.inArray(ext.toLowerCase(), _getTypes($input)) > -1;
+        },
+        errorMessage : 'The file you are trying to upload is of wrong type',
+        errorMessageKey: 'wrongFileType'
+    });
+
+    /**
+     * Validate file size
+     */
+    $.formUtils.addValidator({
+        name : 'size',
+        validate : function(val, $input) {
+            var maxSize = $input.valAttr('max-size');
+            if( !maxSize ) {
+                console.log('Input "'+$input.attr('name')+'" is missing data-validation-max-size attribute');
+                return true;
+            } else if( !SUPPORTS_FILE_READER ) {
+                return true; // no fallback available
+            }
+
+            var maxBytes = $.formUtils.convertSizeNameToBytes(maxSize),
+                valid = true;
+            $.each($input.get(0).files || [], function(i, file) {
+                valid = file.size <= maxBytes;
+                return valid;
+            });
+            return valid;
+        },
+        errorMessage : 'The file you are trying to upload is too large',
+        errorMessageKey: 'wrongFileSize'
+    });
+
+    /**
+     * Make this function accessible via formUtils for unit tests
+     * @param {String} sizeName
+     * @return {Number}
+     */
+    $.formUtils.convertSizeNameToBytes = function(sizeName) {
+        sizeName = sizeName.toUpperCase();
+        if( sizeName.substr(sizeName.length-1, 1) == 'M' ) {
+            return parseInt(sizeName.substr(0, sizeName.length-1), 10) * 1024 * 1024;
+        } else if( sizeName.substr(sizeName.length-2, 2) == 'MB' ) {
+            return parseInt(sizeName.substr(0, sizeName.length-2), 10) * 1024 * 1024;
+        } else if( sizeName.substr(sizeName.length-2, 2) == 'KB' ) {
+            return parseInt(sizeName.substr(0, sizeName.length-2), 10) * 1024;
+        } else if( sizeName.substr(sizeName.length-1, 1) == 'B' ) {
+            return parseInt(sizeName.substr(0, sizeName.length-1), 10);
+        } else {
+            return parseInt(sizeName, 10);
+        }
+    };
+
+    /*
+     * This event listener will remove error messages for file
+     * inputs when file changes
+     */
+    $.formUtils.on('load', function() {
+        $('input[type="file"]').filter('*[data-validation]').bind('change', function() {
+            $(this).parent().find('.form-error').remove();
+        });
+    });
+
+})(jQuery, window);

form-validator/file.dev.js

@@ -2,10 +2,10 @@
 * jQuery Form Validator
 * ------------------------------------------
 * Created by Victor Jonsson <http://www.victorjonsson.se>
-* Documentation and issue tracking on Github <https://github.com/victorjonsson/jQuery-Form-Validator/>
 *
+* @website http://formvalidator.net/
 * @license Dual licensed under the MIT or GPL Version 2 licenses
-* @version 2.0.3
+* @version 2.0.7
 */
 (function($) {
 
@@ -512,7 +512,7 @@
         * @param {Object} validator
         */
         addValidator : function(validator) {
-            var name = validator.name.indexOf('validate_') === 0 ? validator.name : 'validate_'+validator.name;
+            var name = validator.name.indexOf('validate_') === 0 ? validator.name : 'validate_'+validator.name; // legacy...
             this.validators[name] = validator;
         },
 
@@ -522,6 +522,8 @@
          */
         on : function(evt, callback) {
             // Why not use $(document).bind('validators.loaded', func);
+            if( this._events[evt] === undefined )
+                this._events[evt] = [];
             this._events[evt].push(callback);
         },
 
@@ -531,7 +533,7 @@
          * @param [argB]
          */
         trigger : function(evt, argA, argB) {
-            $.each(this._events[evt], function(i, func) {
+            $.each(this._events[evt] || [], function(i, func) {
                 func(argA, argB);
             });
         },
@@ -1070,7 +1072,9 @@
             badNumberOfSelectedOptionsStart : 'You have to choose at least ',
             badNumberOfSelectedOptionsEnd : ' answers',
             badAlphaNumeric : 'The answer you gave must contain only alphanumeric characters ',
-            badAlphaNumericExtra: ' and '
+            badAlphaNumericExtra: ' and ',
+            wrongFileSize : 'The file you are trying to upload is too large',
+            wrongFileType : 'The file you are trying to upload is of wrong type'
         }
     };
 

form-validator/file.js

@@ -2,24 +2,23 @@
  * jQuery Form Validator Module: Date
  * ------------------------------------------
  * Created by Victor Jonsson <http://www.victorjonsson.se>
- * Documentation and issue tracking on Github <https://github.com/victorjonsson/jQuery-Form-Validator/>
  *
  * The following validators will be added by this module:
- *  - validate_country
- *  - validate_state
- *  - validate_longlat
- *
+ *  - Country
+ *  - US state
+ *  - longitude and latitude
  *
+ * @website http://formvalidator.net/#location-validators
  * @license Dual licensed under the MIT or GPL Version 2 licenses
- * @version 2.0.3
+ * @version 2.0.7
  */
 (function($) {
 
     /*
      * Validate that country exists
      */
     $.formUtils.addValidator({
-        name : 'validate_country',
+        name : 'country',
         validate : function(str) {
             return $.inArray(str.toLowerCase(), this.countries) > -1;
         },
@@ -32,7 +31,7 @@
      * Is this a valid federate state in the US
      */
     $.formUtils.addValidator({
-        name : 'validate_federatestate',
+        name : 'federatestate',
         validate : function(str) {
             return $.inArray(str.toLowerCase(), this.states) > -1;
         },
@@ -43,7 +42,7 @@
 
 
     $.formUtils.addValidator({
-        name : 'validate_longlat',
+        name : 'longlat',
         validate : function(str) {
             var regexp = /^[+-]?\d+\.\d+, ?[+-]?\d+\.\d+$/;
             return regexp.test(str);