mirror of
				https://github.com/yiisoft/yii2.git
				synced 2025-10-31 18:47:33 +08:00 
			
		
		
		
	Moved "framework" to "iii".
This commit is contained in:
		| @ -1,387 +0,0 @@ | ||||
| /** | ||||
|  * Yii form widget. | ||||
|  * | ||||
|  * This is the JavaScript widget used by the yii\widgets\ActiveForm widget. | ||||
|  * | ||||
|  * @link http://www.yiiframework.com/ | ||||
|  * @copyright Copyright (c) 2008 Yii Software LLC | ||||
|  * @license http://www.yiiframework.com/license/ | ||||
|  * @author Qiang Xue <qiang.xue@gmail.com> | ||||
|  * @since 2.0 | ||||
|  */ | ||||
| (function ($) { | ||||
| 	 | ||||
| 	$.fn.yiiActiveForm = function (method) { | ||||
| 		if (methods[method]) { | ||||
| 			return methods[method].apply(this, Array.prototype.slice.call(arguments, 1)); | ||||
| 		} else if (typeof method === 'object' || !method) { | ||||
| 			return methods.init.apply(this, arguments); | ||||
| 		} else { | ||||
| 			$.error('Method ' + method + ' does not exist on jQuery.yiiActiveForm'); | ||||
| 			return false; | ||||
| 		} | ||||
| 	}; | ||||
|  | ||||
| 	var defaults = { | ||||
| 		// the jQuery selector for the error summary | ||||
| 		errorSummary: undefined, | ||||
| 		// whether to perform validation before submitting the form. | ||||
| 		validateOnSubmit: true, | ||||
| 		// the container CSS class representing the corresponding attribute has validation error | ||||
| 		errorCssClass: 'error', | ||||
| 		// the container CSS class representing the corresponding attribute passes validation | ||||
| 		successCssClass: 'success', | ||||
| 		// the container CSS class representing the corresponding attribute is being validated | ||||
| 		validatingCssClass: 'validating', | ||||
| 		// the URL for performing AJAX-based validation. If not set, it will use the the form's action | ||||
| 		validationUrl: undefined, | ||||
| 		// a callback that is called before submitting the form. The signature of the callback should be: | ||||
| 		// function ($form) { ...return false to cancel submission...} | ||||
| 		beforeSubmit: undefined, | ||||
| 		// a callback that is called before validating each attribute. The signature of the callback should be: | ||||
| 		// function ($form, attribute, messages) { ...return false to cancel the validation...} | ||||
| 		beforeValidate: undefined, | ||||
| 		// the GET parameter name indicating an AJAX-based validation | ||||
| 		ajaxVar: 'ajax' | ||||
| 	}; | ||||
|  | ||||
| 	var attributeDefaults = { | ||||
| 		// attribute name or expression (e.g. "[0]content" for tabular input) | ||||
| 		name: undefined, | ||||
| 		// the jQuery selector of the container of the input field | ||||
| 		container: undefined, | ||||
| 		// the jQuery selector of the input field | ||||
| 		input: undefined, | ||||
| 		// the jQuery selector of the error tag | ||||
| 		error: undefined, | ||||
| 		// whether to perform validation when a change is detected on the input | ||||
| 		validateOnChange: false, | ||||
| 		// whether to perform validation when the user is typing. | ||||
|    		validateOnType: false, | ||||
| 		// number of milliseconds that the validation should be delayed when a user is typing in the input field. | ||||
| 		validationDelay: 200, | ||||
| 		// whether to enable AJAX-based validation. | ||||
| 		enableAjaxValidation: false, | ||||
| 		// function (attribute, value, messages), the client-side validation function. | ||||
| 		validate: undefined, | ||||
| 		// status of the input field, 0: empty, not entered before, 1: validated, 2: pending validation, 3: validating | ||||
| 		status: 0, | ||||
| 		// the value of the input | ||||
| 		value: undefined | ||||
| 	}; | ||||
|  | ||||
| 	var methods = { | ||||
| 		init: function (attributes, options) { | ||||
| 			return this.each(function () { | ||||
| 				var $form = $(this); | ||||
| 				if ($form.data('yiiActiveForm')) { | ||||
| 					return; | ||||
| 				} | ||||
|  | ||||
| 				var settings = $.extend({}, defaults, options || {}); | ||||
| 				if (settings.validationUrl === undefined) { | ||||
| 					settings.validationUrl = $form.attr('action'); | ||||
| 				} | ||||
| 				$.each(attributes, function (i) { | ||||
| 					attributes[i] = $.extend({value: getValue($form, this)}, attributeDefaults, this); | ||||
| 				}); | ||||
| 				$form.data('yiiActiveForm', { | ||||
| 					settings: settings, | ||||
| 					attributes: attributes, | ||||
| 					submitting: false, | ||||
| 					validated: false | ||||
| 				}); | ||||
|  | ||||
| 				watchAttributes($form, attributes); | ||||
|  | ||||
| 				/** | ||||
| 				 * Clean up error status when the form is reset. | ||||
| 				 * Note that $form.on('reset', ...) does work because the "reset" event does not bubble on IE. | ||||
| 				 */ | ||||
| 				$form.bind('reset.yiiActiveForm', methods.resetForm); | ||||
|  | ||||
| 				if (settings.validateOnSubmit) { | ||||
| 					$form.on('mouseup.yiiActiveForm keyup.yiiActiveForm', ':submit', function () { | ||||
| 						$form.data('yiiActiveForm').submitObject = $(this); | ||||
| 					}); | ||||
| 					$form.on('submit', methods.submitForm); | ||||
| 				} | ||||
| 			}); | ||||
| 		}, | ||||
|  | ||||
| 		destroy: function () { | ||||
| 			return this.each(function () { | ||||
| 				$(window).unbind('.yiiActiveForm'); | ||||
| 				$(this).removeData('yiiActiveForm'); | ||||
| 			}); | ||||
| 		}, | ||||
|  | ||||
| 		data: function() { | ||||
| 			return this.data('yiiActiveForm'); | ||||
| 		}, | ||||
|  | ||||
| 		submitForm: function () { | ||||
| 			var $form = $(this), | ||||
| 				data = $form.data('yiiActiveForm'); | ||||
| 			if (data.validated) { | ||||
| 				// continue submitting the form since validation passes | ||||
| 				data.validated = false; | ||||
| 				return true; | ||||
| 			} | ||||
|  | ||||
| 			if (data.settings.timer !== undefined) { | ||||
| 				clearTimeout(data.settings.timer); | ||||
| 			} | ||||
| 			data.submitting = true; | ||||
| 			if (!data.settings.beforeSubmit || data.settings.beforeSubmit($form)) { | ||||
| 				validate($form, function (messages) { | ||||
| 					var hasError = false; | ||||
| 					$.each(data.attributes, function () { | ||||
| 						hasError = updateInput($form, this, messages) || hasError; | ||||
| 					}); | ||||
| 					updateSummary($form, messages); | ||||
| 					if (!hasError) { | ||||
| 						data.validated = true; | ||||
| 						var $button = data.submitObject || $form.find(':submit:first'); | ||||
| 						// TODO: if the submission is caused by "change" event, it will not work | ||||
| 						if ($button.length) { | ||||
| 							$button.click(); | ||||
| 						} else { | ||||
| 							// no submit button in the form | ||||
| 							$form.submit(); | ||||
| 						} | ||||
| 						return; | ||||
| 					} | ||||
| 					data.submitting = false; | ||||
| 				}, function () { | ||||
| 					data.submitting = false; | ||||
| 				}); | ||||
| 			} else { | ||||
| 				data.submitting = false; | ||||
| 			} | ||||
| 			return false; | ||||
| 		}, | ||||
|  | ||||
| 		resetForm: function () { | ||||
| 			var $form = $(this); | ||||
| 			var data = $form.data('yiiActiveForm'); | ||||
| 			// Because we bind directly to a form reset event instead of a reset button (that may not exist), | ||||
| 			// when this function is executed form input values have not been reset yet. | ||||
| 			// Therefore we do the actual reset work through setTimeout. | ||||
| 			setTimeout(function () { | ||||
| 				$.each(data.attributes, function () { | ||||
| 					// Without setTimeout() we would get the input values that are not reset yet. | ||||
| 					this.value = getValue($form, this); | ||||
| 					this.status = 0; | ||||
| 					var $container = $form.find(this.container); | ||||
| 					$container.removeClass( | ||||
| 						data.settings.validatingCssClass + ' ' + | ||||
| 							data.settings.errorCssClass + ' ' + | ||||
| 							data.settings.successCssClass | ||||
| 					); | ||||
| 					$container.find(this.error).html(''); | ||||
| 				}); | ||||
| 				$form.find(data.settings.summary).hide().find('ul').html(''); | ||||
| 			}, 1); | ||||
| 		} | ||||
| 	}; | ||||
|  | ||||
| 	var watchAttributes = function ($form, attributes) { | ||||
| 		$.each(attributes, function (i, attribute) { | ||||
| 			var $input = findInput($form, attribute); | ||||
| 			if (attribute.validateOnChange) { | ||||
| 				$input.on('change.yiiActiveForm', function () { | ||||
| 					validateAttribute($form, attribute, false); | ||||
| 				}).on('blur.yiiActiveForm', function () { | ||||
| 					if (attribute.status == 0 || attribute.status == 1) { | ||||
| 						validateAttribute($form, attribute, !attribute.status); | ||||
| 					} | ||||
| 				}); | ||||
| 			} | ||||
| 			if (attribute.validateOnType) { | ||||
| 				$input.on('keyup.yiiActiveForm', function () { | ||||
| 					if (attribute.value !== getValue($form, attribute)) { | ||||
| 						validateAttribute($form, attribute, false); | ||||
| 					} | ||||
| 				}); | ||||
| 			} | ||||
| 		}); | ||||
| 	}; | ||||
|  | ||||
| 	var validateAttribute = function ($form, attribute, forceValidate) { | ||||
| 		var data = $form.data('yiiActiveForm'); | ||||
|  | ||||
| 		if (forceValidate) { | ||||
| 			attribute.status = 2; | ||||
| 		} | ||||
| 		$.each(data.attributes, function () { | ||||
| 			if (this.value !== getValue($form, this)) { | ||||
| 				this.status = 2; | ||||
| 				forceValidate = true; | ||||
| 			} | ||||
| 		}); | ||||
| 		if (!forceValidate) { | ||||
| 			return; | ||||
| 		} | ||||
|  | ||||
| 		if (data.settings.timer !== undefined) { | ||||
| 			clearTimeout(data.settings.timer); | ||||
| 		} | ||||
| 		data.settings.timer = setTimeout(function () { | ||||
| 			if (data.submitting || $form.is(':hidden')) { | ||||
| 				return; | ||||
| 			} | ||||
| 			$.each(data.attributes, function () { | ||||
| 				if (this.status === 2) { | ||||
| 					this.status = 3; | ||||
| 					$form.find(this.container).addClass(data.settings.validatingCssClass); | ||||
| 				} | ||||
| 			}); | ||||
| 			validate($form, function (messages) { | ||||
| 				var hasError = false; | ||||
| 				$.each(data.attributes, function () { | ||||
| 					if (this.status === 2 || this.status === 3) { | ||||
| 						hasError = updateInput($form, this, messages) || hasError; | ||||
| 					} | ||||
| 				}); | ||||
| 			}); | ||||
| 		}, data.settings.validationDelay); | ||||
| 	}; | ||||
| 	 | ||||
| 	/** | ||||
| 	 * Performs validation. | ||||
| 	 * @param $form jQuery the jquery representation of the form | ||||
| 	 * @param successCallback function the function to be invoked if the validation completes | ||||
| 	 * @param errorCallback function the function to be invoked if the ajax validation request fails | ||||
| 	 */ | ||||
| 	var validate = function ($form, successCallback, errorCallback) { | ||||
| 		var data = $form.data('yiiActiveForm'), | ||||
| 			needAjaxValidation = false, | ||||
| 			messages = {}; | ||||
|  | ||||
| 		$.each(data.attributes, function () { | ||||
| 			if (data.submitting || this.status === 2 || this.status === 3) { | ||||
| 				var msg = []; | ||||
| 				if (!data.settings.beforeValidate || data.settings.beforeValidate($form, this, msg)) { | ||||
| 					if (this.validate) { | ||||
| 						this.validate(this, getValue($form, this), msg); | ||||
| 					} | ||||
| 					if (msg.length) { | ||||
| 						messages[this.name] = msg; | ||||
| 					} else if (this.enableAjaxValidation) { | ||||
| 						needAjaxValidation = true; | ||||
| 					} | ||||
| 				} | ||||
| 			} | ||||
| 		}); | ||||
|  | ||||
| 		if (needAjaxValidation && (!data.submitting || $.isEmptyObject(messages))) { | ||||
| 			// Perform ajax validation when at least one input needs it. | ||||
| 			// If the validation is triggered by form submission, ajax validation | ||||
| 			// should be done only when all inputs pass client validation | ||||
| 			var $button = data.submitObject, | ||||
| 				extData = '&' + data.settings.ajaxVar + '=' + $form.attr('id'); | ||||
| 			if ($button && $button.length && $button.attr('name')) { | ||||
| 				extData += '&' + $button.attr('name') + '=' + $button.attr('value'); | ||||
| 			} | ||||
| 			$.ajax({ | ||||
| 				url: data.settings.validationUrl, | ||||
| 				type: $form.attr('method'), | ||||
| 				data: $form.serialize() + extData, | ||||
| 				dataType: 'json', | ||||
| 				success: function (msgs) { | ||||
| 					if (msgs !== null && typeof msgs === 'object') { | ||||
| 						$.each(data.attributes, function () { | ||||
| 							if (!this.enableAjaxValidation) { | ||||
| 								delete msgs[this.name]; | ||||
| 							} | ||||
| 						}); | ||||
| 						successCallback($.extend({}, messages, msgs)); | ||||
| 					} else { | ||||
| 						successCallback(messages); | ||||
| 					} | ||||
| 				}, | ||||
| 				error: errorCallback | ||||
| 			}); | ||||
| 		} else if (data.submitting) { | ||||
| 			// delay callback so that the form can be submitted without problem | ||||
| 			setTimeout(function () { | ||||
| 				successCallback(messages); | ||||
| 			}, 200); | ||||
| 		} else { | ||||
| 			successCallback(messages); | ||||
| 		} | ||||
| 	}; | ||||
|  | ||||
| 	/** | ||||
| 	 * Updates the error message and the input container for a particular attribute. | ||||
| 	 * @param $form the form jQuery object | ||||
| 	 * @param attribute object the configuration for a particular attribute. | ||||
| 	 * @param messages array the validation error messages | ||||
| 	 * @return boolean whether there is a validation error for the specified attribute | ||||
| 	 */ | ||||
| 	var updateInput = function ($form, attribute, messages) { | ||||
| 		var data = $form.data('yiiActiveForm'), | ||||
| 			$input = findInput($form, attribute), | ||||
| 			hasError = false; | ||||
|  | ||||
| 		attribute.status = 1; | ||||
| 		if ($input.length) { | ||||
| 			hasError = messages && $.isArray(messages[attribute.name]) && messages[attribute.name].length; | ||||
| 			var $container = $form.find(attribute.container); | ||||
| 			var $error = $container.find(attribute.error); | ||||
| 			if (hasError) { | ||||
| 				$error.html(messages[attribute.name][0]); | ||||
| 				$container.removeClass(data.settings.validatingCssClass + ' ' + data.settings.successCssClass) | ||||
| 					.addClass(data.settings.errorCssClass); | ||||
| 			} else { | ||||
| 				$error.html(''); | ||||
| 				$container.removeClass(data.settings.validatingCssClass + ' ' + data.settings.errorCssClass + ' ') | ||||
| 					.addClass(data.settings.successCssClass); | ||||
| 			} | ||||
| 			attribute.value = getValue($form, attribute); | ||||
| 		} | ||||
| 		return hasError; | ||||
| 	}; | ||||
|  | ||||
| 	/** | ||||
| 	 * Updates the error summary. | ||||
| 	 * @param $form the form jQuery object | ||||
| 	 * @param messages array the validation error messages | ||||
| 	 */ | ||||
| 	var updateSummary = function ($form, messages) { | ||||
| 		var data = $form.data('yiiActiveForm'), | ||||
| 			$summary = $form.find(data.settings.errorSummary), | ||||
| 			content = ''; | ||||
|  | ||||
| 		if ($summary.length && messages) { | ||||
| 			$.each(data.attributes, function () { | ||||
| 				if ($.isArray(messages[this.name]) && messages[this.name].length) { | ||||
| 					content += '<li>' + messages[this.name][0] + '</li>'; | ||||
| 				} | ||||
| 			}); | ||||
| 			$summary.toggle(content !== '').find('ul').html(content); | ||||
| 		} | ||||
| 	}; | ||||
|  | ||||
| 	var getValue = function ($form, attribute) { | ||||
| 		var $input = findInput($form, attribute); | ||||
| 		var type = $input.attr('type'); | ||||
| 		if (type === 'checkbox' || type === 'radio') { | ||||
| 			return $input.filter(':checked').val(); | ||||
| 		} else { | ||||
| 			return $input.val(); | ||||
| 		} | ||||
| 	}; | ||||
|  | ||||
| 	var findInput = function ($form, attribute) { | ||||
| 		var $input = $form.find(attribute.input); | ||||
| 		if ($input.length && $input[0].tagName.toLowerCase() === 'div') { | ||||
| 			// checkbox list or radio list | ||||
| 			return $input.find('input'); | ||||
| 		} else { | ||||
| 			return $input; | ||||
| 		} | ||||
| 	}; | ||||
|  | ||||
| })(window.jQuery); | ||||
		Reference in New Issue
	
	Block a user
	 Qiang Xue
					Qiang Xue