| 1 | // Unobtrusive validation support library for jQuery and jQuery Validate |
| 2 | // Copyright (c) .NET Foundation. All rights reserved. |
| 3 | // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information. |
| 4 | // @version v3.2.11 |
| 5 | |
| 6 | /*jslint white: true, browser: true, onevar: true, undef: true, nomen: true, eqeqeq: true, plusplus: true, bitwise: true, regexp: true, newcap: true, immed: true, strict: false */ |
| 7 | /*global document: false, jQuery: false */ |
| 8 | |
| 9 | (function (factory) { |
| 10 | if (typeof define === 'function' && define.amd) { |
| 11 | // AMD. Register as an anonymous module. |
| 12 | define("jquery.validate.unobtrusive", ['jquery-validation'], factory); |
| 13 | } else if (typeof module === 'object' && module.exports) { |
| 14 | // CommonJS-like environments that support module.exports |
| 15 | module.exports = factory(require('jquery-validation')); |
| 16 | } else { |
| 17 | // Browser global |
| 18 | jQuery.validator.unobtrusive = factory(jQuery); |
| 19 | } |
| 20 | }(function ($) { |
| 21 | var $jQval = $.validator, |
| 22 | adapters, |
| 23 | data_validation = "unobtrusiveValidation"; |
| 24 | |
| 25 | function setValidationValues(options, ruleName, value) { |
| 26 | options.rules[ruleName] = value; |
| 27 | if (options.message) { |
| 28 | options.messages[ruleName] = options.message; |
| 29 | } |
| 30 | } |
| 31 | |
| 32 | function splitAndTrim(value) { |
| 33 | return value.replace(/^\s+|\s+$/g, "").split(/\s*,\s*/g); |
| 34 | } |
| 35 | |
| 36 | function escapeAttributeValue(value) { |
| 37 | // As mentioned on http://api.jquery.com/category/selectors/ |
| 38 | return value.replace(/([!"#$%&'()*+,./:;<=>?@\[\\\]^`{|}~])/g, "\\$1"); |
| 39 | } |
| 40 | |
| 41 | function getModelPrefix(fieldName) { |
| 42 | return fieldName.substr(0, fieldName.lastIndexOf(".") + 1); |
| 43 | } |
| 44 | |
| 45 | function appendModelPrefix(value, prefix) { |
| 46 | if (value.indexOf("*.") === 0) { |
| 47 | value = value.replace("*.", prefix); |
| 48 | } |
| 49 | return value; |
| 50 | } |
| 51 | |
| 52 | function onError(error, inputElement) { // 'this' is the form element |
| 53 | var container = $(this).find("[data-valmsg-for='" + escapeAttributeValue(inputElement[0].name) + "']"), |
| 54 | replaceAttrValue = container.attr("data-valmsg-replace"), |
| 55 | replace = replaceAttrValue ? $.parseJSON(replaceAttrValue) !== false : null; |
| 56 | |
| 57 | container.removeClass("field-validation-valid").addClass("field-validation-error"); |
| 58 | error.data("unobtrusiveContainer", container); |
| 59 | |
| 60 | if (replace) { |
| 61 | container.empty(); |
| 62 | error.removeClass("input-validation-error").appendTo(container); |
| 63 | } |
| 64 | else { |
| 65 | error.hide(); |
| 66 | } |
| 67 | } |
| 68 | |
| 69 | function onErrors(event, validator) { // 'this' is the form element |
| 70 | var container = $(this).find("[data-valmsg-summary=true]"), |
| 71 | list = container.find("ul"); |
| 72 | |
| 73 | if (list && list.length && validator.errorList.length) { |
| 74 | list.empty(); |
| 75 | container.addClass("validation-summary-errors").removeClass("validation-summary-valid"); |
| 76 | |
| 77 | $.each(validator.errorList, function () { |
| 78 | $("<li />").html(this.message).appendTo(list); |
| 79 | }); |
| 80 | } |
| 81 | } |
| 82 | |
| 83 | function onSuccess(error) { // 'this' is the form element |
| 84 | var container = error.data("unobtrusiveContainer"); |
| 85 | |
| 86 | if (container) { |
| 87 | var replaceAttrValue = container.attr("data-valmsg-replace"), |
| 88 | replace = replaceAttrValue ? $.parseJSON(replaceAttrValue) : null; |
| 89 | |
| 90 | container.addClass("field-validation-valid").removeClass("field-validation-error"); |
| 91 | error.removeData("unobtrusiveContainer"); |
| 92 | |
| 93 | if (replace) { |
| 94 | container.empty(); |
| 95 | } |
| 96 | } |
| 97 | } |
| 98 | |
| 99 | function onReset(event) { // 'this' is the form element |
| 100 | var $form = $(this), |
| 101 | key = '__jquery_unobtrusive_validation_form_reset'; |
| 102 | if ($form.data(key)) { |
| 103 | return; |
| 104 | } |
| 105 | // Set a flag that indicates we're currently resetting the form. |
| 106 | $form.data(key, true); |
| 107 | try { |
| 108 | $form.data("validator").resetForm(); |
| 109 | } finally { |
| 110 | $form.removeData(key); |
| 111 | } |
| 112 | |
| 113 | $form.find(".validation-summary-errors") |
| 114 | .addClass("validation-summary-valid") |
| 115 | .removeClass("validation-summary-errors"); |
| 116 | $form.find(".field-validation-error") |
| 117 | .addClass("field-validation-valid") |
| 118 | .removeClass("field-validation-error") |
| 119 | .removeData("unobtrusiveContainer") |
| 120 | .find(">*") // If we were using valmsg-replace, get the underlying error |
| 121 | .removeData("unobtrusiveContainer"); |
| 122 | } |
| 123 | |
| 124 | function validationInfo(form) { |
| 125 | var $form = $(form), |
| 126 | result = $form.data(data_validation), |
| 127 | onResetProxy = $.proxy(onReset, form), |
| 128 | defaultOptions = $jQval.unobtrusive.options || {}, |
| 129 | execInContext = function (name, args) { |
| 130 | var func = defaultOptions[name]; |
| 131 | func && $.isFunction(func) && func.apply(form, args); |
| 132 | }; |
| 133 | |
| 134 | if (!result) { |
| 135 | result = { |
| 136 | options: { // options structure passed to jQuery Validate's validate() method |
| 137 | errorClass: defaultOptions.errorClass || "input-validation-error", |
| 138 | errorElement: defaultOptions.errorElement || "span", |
| 139 | errorPlacement: function () { |
| 140 | onError.apply(form, arguments); |
| 141 | execInContext("errorPlacement", arguments); |
| 142 | }, |
| 143 | invalidHandler: function () { |
| 144 | onErrors.apply(form, arguments); |
| 145 | execInContext("invalidHandler", arguments); |
| 146 | }, |
| 147 | messages: {}, |
| 148 | rules: {}, |
| 149 | success: function () { |
| 150 | onSuccess.apply(form, arguments); |
| 151 | execInContext("success", arguments); |
| 152 | } |
| 153 | }, |
| 154 | attachValidation: function () { |
| 155 | $form |
| 156 | .off("reset." + data_validation, onResetProxy) |
| 157 | .on("reset." + data_validation, onResetProxy) |
| 158 | .validate(this.options); |
| 159 | }, |
| 160 | validate: function () { // a validation function that is called by unobtrusive Ajax |
| 161 | $form.validate(); |
| 162 | return $form.valid(); |
| 163 | } |
| 164 | }; |
| 165 | $form.data(data_validation, result); |
| 166 | } |
| 167 | |
| 168 | return result; |
| 169 | } |
| 170 | |
| 171 | $jQval.unobtrusive = { |
| 172 | adapters: [], |
| 173 | |
| 174 | parseElement: function (element, skipAttach) { |
| 175 | /// <summary> |
| 176 | /// Parses a single HTML element for unobtrusive validation attributes. |
| 177 | /// </summary> |
| 178 | /// <param name="element" domElement="true">The HTML element to be parsed.</param> |
| 179 | /// <param name="skipAttach" type="Boolean">[Optional] true to skip attaching the |
| 180 | /// validation to the form. If parsing just this single element, you should specify true. |
| 181 | /// If parsing several elements, you should specify false, and manually attach the validation |
| 182 | /// to the form when you are finished. The default is false.</param> |
| 183 | var $element = $(element), |
| 184 | form = $element.parents("form")[0], |
| 185 | valInfo, rules, messages; |
| 186 | |
| 187 | if (!form) { // Cannot do client-side validation without a form |
| 188 | return; |
| 189 | } |
| 190 | |
| 191 | valInfo = validationInfo(form); |
| 192 | valInfo.options.rules[element.name] = rules = {}; |
| 193 | valInfo.options.messages[element.name] = messages = {}; |
| 194 | |
| 195 | $.each(this.adapters, function () { |
| 196 | var prefix = "data-val-" + this.name, |
| 197 | message = $element.attr(prefix), |
| 198 | paramValues = {}; |
| 199 | |
| 200 | if (message !== undefined) { // Compare against undefined, because an empty message is legal (and falsy) |
| 201 | prefix += "-"; |
| 202 | |
| 203 | $.each(this.params, function () { |
| 204 | paramValues[this] = $element.attr(prefix + this); |
| 205 | }); |
| 206 | |
| 207 | this.adapt({ |
| 208 | element: element, |
| 209 | form: form, |
| 210 | message: message, |
| 211 | params: paramValues, |
| 212 | rules: rules, |
| 213 | messages: messages |
| 214 | }); |
| 215 | } |
| 216 | }); |
| 217 | |
| 218 | $.extend(rules, { "__dummy__": true }); |
| 219 | |
| 220 | if (!skipAttach) { |
| 221 | valInfo.attachValidation(); |
| 222 | } |
| 223 | }, |
| 224 | |
| 225 | parse: function (selector) { |
| 226 | /// <summary> |
| 227 | /// Parses all the HTML elements in the specified selector. It looks for input elements decorated |
| 228 | /// with the [data-val=true] attribute value and enables validation according to the data-val-* |
| 229 | /// attribute values. |
| 230 | /// </summary> |
| 231 | /// <param name="selector" type="String">Any valid jQuery selector.</param> |
| 232 | |
| 233 | // $forms includes all forms in selector's DOM hierarchy (parent, children and self) that have at least one |
| 234 | // element with data-val=true |
| 235 | var $selector = $(selector), |
| 236 | $forms = $selector.parents() |
| 237 | .addBack() |
| 238 | .filter("form") |
| 239 | .add($selector.find("form")) |
| 240 | .has("[data-val=true]"); |
| 241 | |
| 242 | $selector.find("[data-val=true]").each(function () { |
| 243 | $jQval.unobtrusive.parseElement(this, true); |
| 244 | }); |
| 245 | |
| 246 | $forms.each(function () { |
| 247 | var info = validationInfo(this); |
| 248 | if (info) { |
| 249 | info.attachValidation(); |
| 250 | } |
| 251 | }); |
| 252 | } |
| 253 | }; |
| 254 | |
| 255 | adapters = $jQval.unobtrusive.adapters; |
| 256 | |
| 257 | adapters.add = function (adapterName, params, fn) { |
| 258 | /// <summary>Adds a new adapter to convert unobtrusive HTML into a jQuery Validate validation.</summary> |
| 259 | /// <param name="adapterName" type="String">The name of the adapter to be added. This matches the name used |
| 260 | /// in the data-val-nnnn HTML attribute (where nnnn is the adapter name).</param> |
| 261 | /// <param name="params" type="Array" optional="true">[Optional] An array of parameter names (strings) that will |
| 262 | /// be extracted from the data-val-nnnn-mmmm HTML attributes (where nnnn is the adapter name, and |
| 263 | /// mmmm is the parameter name).</param> |
| 264 | /// <param name="fn" type="Function">The function to call, which adapts the values from the HTML |
| 265 | /// attributes into jQuery Validate rules and/or messages.</param> |
| 266 | /// <returns type="jQuery.validator.unobtrusive.adapters" /> |
| 267 | if (!fn) { // Called with no params, just a function |
| 268 | fn = params; |
| 269 | params = []; |
| 270 | } |
| 271 | this.push({ name: adapterName, params: params, adapt: fn }); |
| 272 | return this; |
| 273 | }; |
| 274 | |
| 275 | adapters.addBool = function (adapterName, ruleName) { |
| 276 | /// <summary>Adds a new adapter to convert unobtrusive HTML into a jQuery Validate validation, where |
| 277 | /// the jQuery Validate validation rule has no parameter values.</summary> |
| 278 | /// <param name="adapterName" type="String">The name of the adapter to be added. This matches the name used |
| 279 | /// in the data-val-nnnn HTML attribute (where nnnn is the adapter name).</param> |
| 280 | /// <param name="ruleName" type="String" optional="true">[Optional] The name of the jQuery Validate rule. If not provided, the value |
| 281 | /// of adapterName will be used instead.</param> |
| 282 | /// <returns type="jQuery.validator.unobtrusive.adapters" /> |
| 283 | return this.add(adapterName, function (options) { |
| 284 | setValidationValues(options, ruleName || adapterName, true); |
| 285 | }); |
| 286 | }; |
| 287 | |
| 288 | adapters.addMinMax = function (adapterName, minRuleName, maxRuleName, minMaxRuleName, minAttribute, maxAttribute) { |
| 289 | /// <summary>Adds a new adapter to convert unobtrusive HTML into a jQuery Validate validation, where |
| 290 | /// the jQuery Validate validation has three potential rules (one for min-only, one for max-only, and |
| 291 | /// one for min-and-max). The HTML parameters are expected to be named -min and -max.</summary> |
| 292 | /// <param name="adapterName" type="String">The name of the adapter to be added. This matches the name used |
| 293 | /// in the data-val-nnnn HTML attribute (where nnnn is the adapter name).</param> |
| 294 | /// <param name="minRuleName" type="String">The name of the jQuery Validate rule to be used when you only |
| 295 | /// have a minimum value.</param> |
| 296 | /// <param name="maxRuleName" type="String">The name of the jQuery Validate rule to be used when you only |
| 297 | /// have a maximum value.</param> |
| 298 | /// <param name="minMaxRuleName" type="String">The name of the jQuery Validate rule to be used when you |
| 299 | /// have both a minimum and maximum value.</param> |
| 300 | /// <param name="minAttribute" type="String" optional="true">[Optional] The name of the HTML attribute that |
| 301 | /// contains the minimum value. The default is "min".</param> |
| 302 | /// <param name="maxAttribute" type="String" optional="true">[Optional] The name of the HTML attribute that |
| 303 | /// contains the maximum value. The default is "max".</param> |
| 304 | /// <returns type="jQuery.validator.unobtrusive.adapters" /> |
| 305 | return this.add(adapterName, [minAttribute || "min", maxAttribute || "max"], function (options) { |
| 306 | var min = options.params.min, |
| 307 | max = options.params.max; |
| 308 | |
| 309 | if (min && max) { |
| 310 | setValidationValues(options, minMaxRuleName, [min, max]); |
| 311 | } |
| 312 | else if (min) { |
| 313 | setValidationValues(options, minRuleName, min); |
| 314 | } |
| 315 | else if (max) { |
| 316 | setValidationValues(options, maxRuleName, max); |
| 317 | } |
| 318 | }); |
| 319 | }; |
| 320 | |
| 321 | adapters.addSingleVal = function (adapterName, attribute, ruleName) { |
| 322 | /// <summary>Adds a new adapter to convert unobtrusive HTML into a jQuery Validate validation, where |
| 323 | /// the jQuery Validate validation rule has a single value.</summary> |
| 324 | /// <param name="adapterName" type="String">The name of the adapter to be added. This matches the name used |
| 325 | /// in the data-val-nnnn HTML attribute(where nnnn is the adapter name).</param> |
| 326 | /// <param name="attribute" type="String">[Optional] The name of the HTML attribute that contains the value. |
| 327 | /// The default is "val".</param> |
| 328 | /// <param name="ruleName" type="String" optional="true">[Optional] The name of the jQuery Validate rule. If not provided, the value |
| 329 | /// of adapterName will be used instead.</param> |
| 330 | /// <returns type="jQuery.validator.unobtrusive.adapters" /> |
| 331 | return this.add(adapterName, [attribute || "val"], function (options) { |
| 332 | setValidationValues(options, ruleName || adapterName, options.params[attribute]); |
| 333 | }); |
| 334 | }; |
| 335 | |
| 336 | $jQval.addMethod("__dummy__", function (value, element, params) { |
| 337 | return true; |
| 338 | }); |
| 339 | |
| 340 | $jQval.addMethod("regex", function (value, element, params) { |
| 341 | var match; |
| 342 | if (this.optional(element)) { |
| 343 | return true; |
| 344 | } |
| 345 | |
| 346 | match = new RegExp(params).exec(value); |
| 347 | return (match && (match.index === 0) && (match[0].length === value.length)); |
| 348 | }); |
| 349 | |
| 350 | $jQval.addMethod("nonalphamin", function (value, element, nonalphamin) { |
| 351 | var match; |
| 352 | if (nonalphamin) { |
| 353 | match = value.match(/\W/g); |
| 354 | match = match && match.length >= nonalphamin; |
| 355 | } |
| 356 | return match; |
| 357 | }); |
| 358 | |
| 359 | if ($jQval.methods.extension) { |
| 360 | adapters.addSingleVal("accept", "mimtype"); |
| 361 | adapters.addSingleVal("extension", "extension"); |
| 362 | } else { |
| 363 | // for backward compatibility, when the 'extension' validation method does not exist, such as with versions |
| 364 | // of JQuery Validation plugin prior to 1.10, we should use the 'accept' method for |
| 365 | // validating the extension, and ignore mime-type validations as they are not supported. |
| 366 | adapters.addSingleVal("extension", "extension", "accept"); |
| 367 | } |
| 368 | |
| 369 | adapters.addSingleVal("regex", "pattern"); |
| 370 | adapters.addBool("creditcard").addBool("date").addBool("digits").addBool("email").addBool("number").addBool("url"); |
| 371 | adapters.addMinMax("length", "minlength", "maxlength", "rangelength").addMinMax("range", "min", "max", "range"); |
| 372 | adapters.addMinMax("minlength", "minlength").addMinMax("maxlength", "minlength", "maxlength"); |
| 373 | adapters.add("equalto", ["other"], function (options) { |
| 374 | var prefix = getModelPrefix(options.element.name), |
| 375 | other = options.params.other, |
| 376 | fullOtherName = appendModelPrefix(other, prefix), |
| 377 | element = $(options.form).find(":input").filter("[name='" + escapeAttributeValue(fullOtherName) + "']")[0]; |
| 378 | |
| 379 | setValidationValues(options, "equalTo", element); |
| 380 | }); |
| 381 | adapters.add("required", function (options) { |
| 382 | // jQuery Validate equates "required" with "mandatory" for checkbox elements |
| 383 | if (options.element.tagName.toUpperCase() !== "INPUT" || options.element.type.toUpperCase() !== "CHECKBOX") { |
| 384 | setValidationValues(options, "required", true); |
| 385 | } |
| 386 | }); |
| 387 | adapters.add("remote", ["url", "type", "additionalfields"], function (options) { |
| 388 | var value = { |
| 389 | url: options.params.url, |
| 390 | type: options.params.type || "GET", |
| 391 | data: {} |
| 392 | }, |
| 393 | prefix = getModelPrefix(options.element.name); |
| 394 | |
| 395 | $.each(splitAndTrim(options.params.additionalfields || options.element.name), function (i, fieldName) { |
| 396 | var paramName = appendModelPrefix(fieldName, prefix); |
| 397 | value.data[paramName] = function () { |
| 398 | var field = $(options.form).find(":input").filter("[name='" + escapeAttributeValue(paramName) + "']"); |
| 399 | // For checkboxes and radio buttons, only pick up values from checked fields. |
| 400 | if (field.is(":checkbox")) { |
| 401 | return field.filter(":checked").val() || field.filter(":hidden").val() || ''; |
| 402 | } |
| 403 | else if (field.is(":radio")) { |
| 404 | return field.filter(":checked").val() || ''; |
| 405 | } |
| 406 | return field.val(); |
| 407 | }; |
| 408 | }); |
| 409 | |
| 410 | setValidationValues(options, "remote", value); |
| 411 | }); |
| 412 | adapters.add("password", ["min", "nonalphamin", "regex"], function (options) { |
| 413 | if (options.params.min) { |
| 414 | setValidationValues(options, "minlength", options.params.min); |
| 415 | } |
| 416 | if (options.params.nonalphamin) { |
| 417 | setValidationValues(options, "nonalphamin", options.params.nonalphamin); |
| 418 | } |
| 419 | if (options.params.regex) { |
| 420 | setValidationValues(options, "regex", options.params.regex); |
| 421 | } |
| 422 | }); |
| 423 | adapters.add("fileextensions", ["extensions"], function (options) { |
| 424 | setValidationValues(options, "extension", options.params.extensions); |
| 425 | }); |
| 426 | |
| 427 | $(function () { |
| 428 | $jQval.unobtrusive.parse(document); |
| 429 | }); |
| 430 | |
| 431 | return $jQval.unobtrusive; |
| 432 | })); |