]> scripts.mit.edu Git - autoinstalls/wordpress.git/blobdiff - wp-includes/js/jquery/jquery.form.js
Wordpress 3.2
[autoinstalls/wordpress.git] / wp-includes / js / jquery / jquery.form.js
index 7a29393537e9b4daa4183005ec428dd4ea13b0e7..43c37ab65b418437b82604051987fe864c5bbec9 100644 (file)
-/*\r
- * jQuery form plugin\r
- * @requires jQuery v1.0.3\r
- *\r
- * Dual licensed under the MIT and GPL licenses:\r
- *   http://www.opensource.org/licenses/mit-license.php\r
- *   http://www.gnu.org/licenses/gpl.html\r
- *\r
- * Revision: $Id$\r
- * Version: 0.9\r
- */\r
-\r
-/**\r
- * ajaxSubmit() provides a mechanism for submitting an HTML form using AJAX.\r
- *\r
- * ajaxSubmit accepts a single argument which can be either a success callback function\r
- * or an options Object.  If a function is provided it will be invoked upon successful\r
- * completion of the submit and will be passed the response from the server.\r
- * If an options Object is provided, the following attributes are supported:\r
- *\r
- *  target:   Identifies the element(s) in the page to be updated with the server response.\r
- *            This value may be specified as a jQuery selection string, a jQuery object,\r
- *            or a DOM element.\r
- *            default value: null\r
- *\r
- *  url:      URL to which the form data will be submitted.\r
- *            default value: value of form's 'action' attribute\r
- *\r
- *  method:   @deprecated use 'type'\r
- *  type:     The method in which the form data should be submitted, 'GET' or 'POST'.\r
- *            default value: value of form's 'method' attribute (or 'GET' if none found)\r
- *\r
- *  before:   @deprecated use 'beforeSubmit'\r
- *  beforeSubmit:  Callback method to be invoked before the form is submitted.\r
- *            default value: null\r
- *\r
- *  after:    @deprecated use 'success'\r
- *  success:  Callback method to be invoked after the form has been successfully submitted\r
- *            and the response has been returned from the server\r
- *            default value: null\r
- *\r
- *  dataType: Expected dataType of the response.  One of: null, 'xml', 'script', or 'json'\r
- *            default value: null\r
- *\r
- *  semantic: Boolean flag indicating whether data must be submitted in semantic order (slower).\r
- *            default value: false\r
- *\r
- *  resetForm: Boolean flag indicating whether the form should be reset if the submit is successful\r
- *\r
- *  clearForm: Boolean flag indicating whether the form should be cleared if the submit is successful\r
- *\r
- *\r
- * The 'beforeSubmit' callback can be provided as a hook for running pre-submit logic or for\r
- * validating the form data.  If the 'beforeSubmit' callback returns false then the form will\r
- * not be submitted. The 'beforeSubmit' callback is invoked with three arguments: the form data\r
- * in array format, the jQuery object, and the options object passed into ajaxSubmit.\r
- * The form data array takes the following form:\r
- *\r
- *     [ { name: 'username', value: 'jresig' }, { name: 'password', value: 'secret' } ]\r
- *\r
- * If a 'success' callback method is provided it is invoked after the response has been returned\r
- * from the server.  It is passed the responseText or responseXML value (depending on dataType).\r
- * See jQuery.ajax for further details.\r
- *\r
- *\r
- * The dataType option provides a means for specifying how the server response should be handled.\r
- * This maps directly to the jQuery.httpData method.  The following values are supported:\r
- *\r
- *      'xml':    if dataType == 'xml' the server response is treated as XML and the 'after'\r
- *                   callback method, if specified, will be passed the responseXML value\r
- *      'json':   if dataType == 'json' the server response will be evaluted and passed to\r
- *                   the 'after' callback, if specified\r
- *      'script': if dataType == 'script' the server response is evaluated in the global context\r
- *\r
- *\r
- * Note that it does not make sense to use both the 'target' and 'dataType' options.  If both\r
- * are provided the target will be ignored.\r
- *\r
- * The semantic argument can be used to force form serialization in semantic order.\r
- * This is normally true anyway, unless the form contains input elements of type='image'.\r
- * If your form must be submitted with name/value pairs in semantic order and your form\r
- * contains an input of type='image" then pass true for this arg, otherwise pass false\r
- * (or nothing) to avoid the overhead for this logic.\r
- *\r
- *\r
- * When used on its own, ajaxSubmit() is typically bound to a form's submit event like this:\r
- *\r
- * $("#form-id").submit(function() {\r
- *     $(this).ajaxSubmit(options);\r
- *     return false; // cancel conventional submit\r
- * });\r
- *\r
- * When using ajaxForm(), however, this is done for you.\r
- *\r
- * @example\r
- * $('#myForm').ajaxSubmit(function(data) {\r
- *     alert('Form submit succeeded! Server returned: ' + data);\r
- * });\r
- * @desc Submit form and alert server response\r
- *\r
- *\r
- * @example\r
- * var options = {\r
- *     target: '#myTargetDiv'\r
- * };\r
- * $('#myForm').ajaxSubmit(options);\r
- * @desc Submit form and update page element with server response\r
- *\r
- *\r
- * @example\r
- * var options = {\r
- *     success: function(responseText) {\r
- *         alert(responseText);\r
- *     }\r
- * };\r
- * $('#myForm').ajaxSubmit(options);\r
- * @desc Submit form and alert the server response\r
- *\r
- *\r
- * @example\r
- * var options = {\r
- *     beforeSubmit: function(formArray, jqForm) {\r
- *         if (formArray.length == 0) {\r
- *             alert('Please enter data.');\r
- *             return false;\r
- *         }\r
- *     }\r
- * };\r
- * $('#myForm').ajaxSubmit(options);\r
- * @desc Pre-submit validation which aborts the submit operation if form data is empty\r
- *\r
- *\r
- * @example\r
- * var options = {\r
- *     url: myJsonUrl.php,\r
- *     dataType: 'json',\r
- *     success: function(data) {\r
- *        // 'data' is an object representing the the evaluated json data\r
- *     }\r
- * };\r
- * $('#myForm').ajaxSubmit(options);\r
- * @desc json data returned and evaluated\r
- *\r
- *\r
- * @example\r
- * var options = {\r
- *     url: myXmlUrl.php,\r
- *     dataType: 'xml',\r
- *     success: function(responseXML) {\r
- *        // responseXML is XML document object\r
- *        var data = $('myElement', responseXML).text();\r
- *     }\r
- * };\r
- * $('#myForm').ajaxSubmit(options);\r
- * @desc XML data returned from server\r
- *\r
- *\r
- * @example\r
- * var options = {\r
- *     resetForm: true\r
- * };\r
- * $('#myForm').ajaxSubmit(options);\r
- * @desc submit form and reset it if successful\r
- *\r
- * @example\r
- * $('#myForm).submit(function() {\r
- *    $(this).ajaxSubmit();\r
- *    return false;\r
- * });\r
- * @desc Bind form's submit event to use ajaxSubmit\r
- *\r
- *\r
- * @name ajaxSubmit\r
- * @type jQuery\r
- * @param options  object literal containing options which control the form submission process\r
- * @cat Plugins/Form\r
- * @return jQuery\r
- * @see formToArray\r
- * @see ajaxForm\r
- * @see $.ajax\r
- * @author jQuery Community\r
- */\r
-jQuery.fn.ajaxSubmit = function(options) {\r
-    if (typeof options == 'function')\r
-        options = { success: options };\r
-\r
-    options = jQuery.extend({\r
-        url:    this.attr('action') || '',\r
-        method: this.attr('method') || 'GET'\r
-    }, options || {});\r
-\r
-    // remap deprecated options (temporarily)\r
-    options.success = options.success || options.after;\r
-    options.beforeSubmit = options.beforeSubmit || options.before;\r
-    options.type = options.type || options.method;\r
-\r
-    var a = this.formToArray(options.semantic);\r
-\r
-    // give pre-submit callback an opportunity to abort the submit\r
-    if (options.beforeSubmit && options.beforeSubmit(a, this, options) === false) return this;\r
-\r
-    var q = jQuery.param(a);\r
-\r
-    if (options.type.toUpperCase() == 'GET') {\r
-        // if url already has a '?' then append args after '&'\r
-        options.url += (options.url.indexOf('?') >= 0 ? '&' : '?') + q;\r
-        options.data = null;  // data is null for 'get'\r
-    }\r
-    else\r
-        options.data = q; // data is the query string for 'post'\r
-\r
-    var $form = this, callbacks = [];\r
-    if (options.resetForm) callbacks.push(function() { $form.resetForm(); });\r
-    if (options.clearForm) callbacks.push(function() { $form.clearForm(); });\r
-\r
-    // perform a load on the target only if dataType is not provided\r
-    if (!options.dataType && options.target) {\r
-        var oldSuccess = options.success || function(){};\r
-        callbacks.push(function(data, status) {\r
-            jQuery(options.target).attr("innerHTML", data).evalScripts().each(oldSuccess, [data, status]);\r
-        });\r
-    }\r
-    else if (options.success)\r
-        callbacks.push(options.success);\r
-\r
-    options.success = function(data, status) {\r
-        for (var i=0, max=callbacks.length; i < max; i++)\r
-            callbacks[i](data, status);\r
-    };\r
-\r
-    jQuery.ajax(options);\r
-    return this;\r
-};\r
-\r
-/**\r
- * ajaxForm() provides a mechanism for fully automating form submission.\r
- *\r
- * The advantages of using this method instead of ajaxSubmit() are:\r
- *\r
- * 1: This method will include coordinates for <input type="image" /> elements (if the element\r
- *    is used to submit the form).\r
- * 2. This method will include the submit element's name/value data (for the element that was\r
- *    used to submit the form).\r
- * 3. This method binds the submit() method to the form for you.\r
- *\r
- * Note that for accurate x/y coordinates of image submit elements in all browsers\r
- * you need to also use the "dimensions" plugin (this method will auto-detect its presence).\r
- *\r
- * The options argument for ajaxForm works exactly as it does for ajaxSubmit.  ajaxForm merely\r
- * passes the options argument along after properly binding events for submit elements and\r
- * the form itself.  See ajaxSubmit for a full description of the options argument.\r
- *\r
- *\r
- * @example\r
- * var options = {\r
- *     target: '#myTargetDiv'\r
- * };\r
- * $('#myForm').ajaxSForm(options);\r
- * @desc Bind form's submit event so that 'myTargetDiv' is updated with the server response\r
- *       when the form is submitted.\r
- *\r
- *\r
- * @example\r
- * var options = {\r
- *     success: function(responseText) {\r
- *         alert(responseText);\r
- *     }\r
- * };\r
- * $('#myForm').ajaxSubmit(options);\r
- * @desc Bind form's submit event so that server response is alerted after the form is submitted.\r
- *\r
- *\r
- * @example\r
- * var options = {\r
- *     beforeSubmit: function(formArray, jqForm) {\r
- *         if (formArray.length == 0) {\r
- *             alert('Please enter data.');\r
- *             return false;\r
- *         }\r
- *     }\r
- * };\r
- * $('#myForm').ajaxSubmit(options);\r
- * @desc Bind form's submit event so that pre-submit callback is invoked before the form\r
- *       is submitted.\r
- *\r
- *\r
- * @name   ajaxForm\r
- * @param  options  object literal containing options which control the form submission process\r
- * @return jQuery\r
- * @cat    Plugins/Form\r
- * @type   jQuery\r
- * @see    ajaxSubmit\r
- * @author jQuery Community\r
- */\r
-jQuery.fn.ajaxForm = function(options) {\r
-    return this.each(function() {\r
-        jQuery("input:submit,input:image,button:submit", this).click(function(ev) {\r
-            var $form = this.form;\r
-            $form.clk = this;\r
-            if (this.type == 'image') {\r
-                if (ev.offsetX != undefined) {\r
-                    $form.clk_x = ev.offsetX;\r
-                    $form.clk_y = ev.offsetY;\r
-                } else if (typeof jQuery.fn.offset == 'function') { // try to use dimensions plugin\r
-                    var offset = jQuery(this).offset();\r
-                    $form.clk_x = ev.pageX - offset.left;\r
-                    $form.clk_y = ev.pageY - offset.top;\r
-                } else {\r
-                    $form.clk_x = ev.pageX - this.offsetLeft;\r
-                    $form.clk_y = ev.pageY - this.offsetTop;\r
-                }\r
-            }\r
-            // clear form vars\r
-            setTimeout(function() {\r
-                $form.clk = $form.clk_x = $form.clk_y = null;\r
-                }, 10);\r
-        })\r
-    }).submit(function(e) {\r
-        jQuery(this).ajaxSubmit(options);\r
-        return false;\r
-    });\r
-};\r
-\r
-\r
-/**\r
- * formToArray() gathers form element data into an array of objects that can\r
- * be passed to any of the following ajax functions: $.get, $.post, or load.\r
- * Each object in the array has both a 'name' and 'value' property.  An example of\r
- * an array for a simple login form might be:\r
- *\r
- * [ { name: 'username', value: 'jresig' }, { name: 'password', value: 'secret' } ]\r
- *\r
- * It is this array that is passed to pre-submit callback functions provided to the\r
- * ajaxSubmit() and ajaxForm() methods.\r
- *\r
- * The semantic argument can be used to force form serialization in semantic order.\r
- * This is normally true anyway, unless the form contains input elements of type='image'.\r
- * If your form must be submitted with name/value pairs in semantic order and your form\r
- * contains an input of type='image" then pass true for this arg, otherwise pass false\r
- * (or nothing) to avoid the overhead for this logic.\r
- *\r
- * @example var data = $("#myForm").formToArray();\r
- * $.post( "myscript.cgi", data );\r
- * @desc Collect all the data from a form and submit it to the server.\r
- *\r
- * @name formToArray\r
- * @param semantic true if serialization must maintain strict semantic ordering of elements (slower)\r
- * @type Array<Object>\r
- * @cat Plugins/Form\r
- * @see ajaxForm\r
- * @see ajaxSubmit\r
- * @author jQuery Community\r
- */\r
-jQuery.fn.formToArray = function(semantic) {\r
-    var a = [];\r
-    if (this.length == 0) return a;\r
-\r
-    var form = this[0];\r
-    var els = semantic ? form.getElementsByTagName('*') : form.elements;\r
-    if (!els) return a;\r
-    for(var i=0, max=els.length; i < max; i++) {\r
-        var el = els[i];\r
-        var n = el.name;\r
-        if (!n) continue;\r
-\r
-        if (semantic && form.clk && el.type == "image") {\r
-            // handle image inputs on the fly when semantic == true\r
-            if(!el.disabled && form.clk == el)\r
-                a.push({name: n+'.x', value: form.clk_x}, {name: n+'.y', value: form.clk_y});\r
-            continue;\r
-        }\r
-        var v = jQuery.fieldValue(el, true);\r
-        if (v === null) continue;\r
-        if (v.constructor == Array) {\r
-            for(var j=0, jmax=v.length; j < jmax; j++)\r
-                a.push({name: n, value: v[j]});\r
-        }\r
-        else\r
-            a.push({name: n, value: v});\r
-    }\r
-\r
-    if (!semantic && form.clk) {\r
-        // input type=='image' are not found in elements array! handle them here\r
-        var inputs = form.getElementsByTagName("input");\r
-        for(var i=0, max=inputs.length; i < max; i++) {\r
-            var input = inputs[i];\r
-            var n = input.name;\r
-            if(n && !input.disabled && input.type == "image" && form.clk == input)\r
-                a.push({name: n+'.x', value: form.clk_x}, {name: n+'.y', value: form.clk_y});\r
-        }\r
-    }\r
-    return a;\r
-};\r
-\r
-\r
-/**\r
- * Serializes form data into a 'submittable' string. This method will return a string\r
- * in the format: name1=value1&amp;name2=value2\r
- *\r
- * The semantic argument can be used to force form serialization in semantic order.\r
- * If your form must be submitted with name/value pairs in semantic order then pass\r
- * true for this arg, otherwise pass false (or nothing) to avoid the overhead for\r
- * this logic (which can be significant for very large forms).\r
- *\r
- * @example var data = $("#myForm").formSerialize();\r
- * $.ajax('POST', "myscript.cgi", data);\r
- * @desc Collect all the data from a form into a single string\r
- *\r
- * @name formSerialize\r
- * @param semantic true if serialization must maintain strict semantic ordering of elements (slower)\r
- * @type String\r
- * @cat Plugins/Form\r
- * @see formToArray\r
- * @author jQuery Community\r
- */\r
-jQuery.fn.formSerialize = function(semantic) {\r
-    //hand off to jQuery.param for proper encoding\r
-    return jQuery.param(this.formToArray(semantic));\r
-};\r
-\r
-\r
-/**\r
- * Serializes all field elements in the jQuery object into a query string.\r
- * This method will return a string in the format: name1=value1&amp;name2=value2\r
- *\r
- * The successful argument controls whether or not serialization is limited to\r
- * 'successful' controls (per http://www.w3.org/TR/html4/interact/forms.html#successful-controls).\r
- * The default value of the successful argument is true.\r
- *\r
- * @example var data = $("input").formSerialize();\r
- * @desc Collect the data from all successful input elements into a query string\r
- *\r
- * @example var data = $(":radio").formSerialize();\r
- * @desc Collect the data from all successful radio input elements into a query string\r
- *\r
- * @example var data = $("#myForm :checkbox").formSerialize();\r
- * @desc Collect the data from all successful checkbox input elements in myForm into a query string\r
- *\r
- * @example var data = $("#myForm :checkbox").formSerialize(false);\r
- * @desc Collect the data from all checkbox elements in myForm (even the unchecked ones) into a query string\r
- *\r
- * @example var data = $(":input").formSerialize();\r
- * @desc Collect the data from all successful input, select, textarea and button elements into a query string\r
- *\r
- * @name fieldSerialize\r
- * @param successful true if only successful controls should be serialized (default is true)\r
- * @type String\r
- * @cat Plugins/Form\r
- */\r
-jQuery.fn.fieldSerialize = function(successful) {\r
-    var a = [];\r
-    this.each(function() {\r
-        var n = this.name;\r
-        if (!n) return;\r
-        var v = jQuery.fieldValue(this, successful);\r
-        if (v && v.constructor == Array) {\r
-            for (var i=0,max=v.length; i < max; i++)\r
-                a.push({name: n, value: v[i]});\r
-        }\r
-        else if (v !== null && typeof v != 'undefined')\r
-            a.push({name: this.name, value: v});\r
-    });\r
-    //hand off to jQuery.param for proper encoding\r
-    return jQuery.param(a);\r
-};\r
-\r
-\r
-/**\r
- * Returns the value of the field element in the jQuery object.  If there is more than one field element\r
- * in the jQuery object the value of the first successful one is returned.\r
- *\r
- * The successful argument controls whether or not the field element must be 'successful'\r
- * (per http://www.w3.org/TR/html4/interact/forms.html#successful-controls).\r
- * The default value of the successful argument is true.  If this value is false then\r
- * the value of the first field element in the jQuery object is returned.\r
- *\r
- * Note: If no valid value can be determined the return value will be undifined.\r
- *\r
- * Note: The fieldValue returned for a select-multiple element or for a checkbox input will\r
- *       always be an array if it is not undefined.\r
- *\r
- *\r
- * @example var data = $("#myPasswordElement").formValue();\r
- * @desc Gets the current value of the myPasswordElement element\r
- *\r
- * @example var data = $("#myForm :input").formValue();\r
- * @desc Get the value of the first successful control in the jQuery object.\r
- *\r
- * @example var data = $("#myForm :checkbox").formValue();\r
- * @desc Get the array of values for the first set of successful checkbox controls in the jQuery object.\r
- *\r
- * @example var data = $("#mySingleSelect").formValue();\r
- * @desc Get the value of the select control\r
- *\r
- * @example var data = $("#myMultiSelect").formValue();\r
- * @desc Get the array of selected values for the select-multiple control\r
- *\r
- * @name fieldValue\r
- * @param Boolean successful true if value returned must be for a successful controls (default is true)\r
- * @type String or Array<String>\r
- * @cat Plugins/Form\r
- */\r
-jQuery.fn.fieldValue = function(successful) {\r
-    var cbVal, cbName;\r
-\r
-    // loop until we find a value\r
-    for (var i=0, max=this.length; i < max; i++) {\r
-        var el = this[i];\r
-        var v = jQuery.fieldValue(el, successful);\r
-        if (v === null || typeof v == 'undefined' || (v.constructor == Array && !v.length))\r
-            continue;\r
-\r
-        // for checkboxes, consider multiple elements, for everything else just return first valid value\r
-        if (el.type != 'checkbox') return v;\r
-\r
-        cbName = cbName || el.name;\r
-        if (cbName != el.name) // return if we hit a checkbox with a different name\r
-            return cbVal;\r
-        cbVal = cbVal || [];\r
-        cbVal.push(v);\r
-    }\r
-    return cbVal;\r
-};\r
-\r
-/**\r
- * Returns the value of the field element.\r
- *\r
- * The successful argument controls whether or not the field element must be 'successful'\r
- * (per http://www.w3.org/TR/html4/interact/forms.html#successful-controls).\r
- * The default value of the successful argument is true.  If the given element is not\r
- * successful and the successful arg is not false then the returned value will be null.\r
- *\r
- * Note: The fieldValue returned for a select-multiple element will always be an array.\r
- *\r
- * @example var data = jQuery.fieldValue($("#myPasswordElement")[0]);\r
- * @desc Gets the current value of the myPasswordElement element\r
- *\r
- * @name fieldValue\r
- * @param Element el The DOM element for which the value will be returned\r
- * @param Boolean successful true if value returned must be for a successful controls (default is true)\r
- * @type String or Array<String>\r
- * @cat Plugins/Form\r
- */\r
-jQuery.fieldValue = function(el, successful) {\r
-    var n = el.name, t = el.type, tag = el.tagName.toLowerCase();\r
-    if (typeof successful == 'undefined') successful = true;\r
-\r
-    if (successful && ( !n || el.disabled || t == 'reset' ||\r
-        (t == 'checkbox' || t == 'radio') && !el.checked ||\r
-        (t == 'submit' || t == 'image') && el.form && el.form.clk != el ||\r
-        tag == 'select' && el.selectedIndex == -1))\r
-            return null;\r
-\r
-    if (tag == 'select') {\r
-        var index = el.selectedIndex;\r
-        if (index < 0) return null;\r
-        var a = [], ops = el.options;\r
-        var one = (t == 'select-one');\r
-        var max = (one ? index+1 : ops.length);\r
-        for(var i=(one ? index : 0); i < max; i++) {\r
-            var op = ops[i];\r
-            if (op.selected) {\r
-                // extra pain for IE...\r
-                var v = jQuery.browser.msie && !(op.attributes['value'].specified) ? op.text : op.value;\r
-                if (one) return v;\r
-                a.push(v);\r
-            }\r
-        }\r
-        return a;\r
-    }\r
-    return el.value;\r
-};\r
-\r
-\r
-/**\r
- * Clears the form data.  Takes the following actions on the form's input fields:\r
- *  - input text fields will have their 'value' property set to the empty string\r
- *  - select elements will have their 'selectedIndex' property set to -1\r
- *  - checkbox and radio inputs will have their 'checked' property set to false\r
- *  - inputs of type submit, button, reset, and hidden will *not* be effected\r
- *  - button elements will *not* be effected\r
- *\r
- * @example $('form').clearForm();\r
- * @desc Clears all forms on the page.\r
- *\r
- * @name clearForm\r
- * @type jQuery\r
- * @cat Plugins/Form\r
- * @see resetForm\r
- */\r
-jQuery.fn.clearForm = function() {\r
-    return this.each(function() {\r
-        jQuery('input,select,textarea', this).clearFields();\r
-    });\r
-};\r
-\r
-/**\r
- * Clears the selected form elements.  Takes the following actions on the matched elements:\r
- *  - input text fields will have their 'value' property set to the empty string\r
- *  - select elements will have their 'selectedIndex' property set to -1\r
- *  - checkbox and radio inputs will have their 'checked' property set to false\r
- *  - inputs of type submit, button, reset, and hidden will *not* be effected\r
- *  - button elements will *not* be effected\r
- *\r
- * @example $('.myInputs').clearFields();\r
- * @desc Clears all inputs with class myInputs\r
- *\r
- * @name clearFields\r
- * @type jQuery\r
- * @cat Plugins/Form\r
- * @see clearForm\r
- */\r
-jQuery.fn.clearFields = jQuery.fn.clearInputs = function() {\r
-    return this.each(function() {\r
-        var t = this.type, tag = this.tagName.toLowerCase();\r
-        if (t == 'text' || t == 'password' || tag == 'textarea')\r
-            this.value = '';\r
-        else if (t == 'checkbox' || t == 'radio')\r
-            this.checked = false;\r
-        else if (tag == 'select')\r
-            this.selectedIndex = -1;\r
-    });\r
-};\r
-\r
-\r
-/**\r
- * Resets the form data.  Causes all form elements to be reset to their original value.\r
- *\r
- * @example $('form').resetForm();\r
- * @desc Resets all forms on the page.\r
- *\r
- * @name resetForm\r
- * @type jQuery\r
- * @cat Plugins/Form\r
- * @see clearForm\r
- */\r
-jQuery.fn.resetForm = function() {\r
-    return this.each(function() {\r
-        // guard against an input with the name of 'reset'\r
-        // note that IE reports the reset function as an 'object'\r
-        if (typeof this.reset == 'function' || (typeof this.reset == 'object' && !this.reset.nodeType))\r
-            this.reset();\r
-    });\r
-};\r
+/*
+ * jQuery Form Plugin
+ * version: 2.73 (03-MAY-2011)
+ * @requires jQuery v1.3.2 or later
+ *
+ * Examples and documentation at: http://malsup.com/jquery/form/
+ * Dual licensed under the MIT and GPL licenses:
+ *   http://www.opensource.org/licenses/mit-license.php
+ *   http://www.gnu.org/licenses/gpl.html
+ */
+(function(b){b.fn.ajaxSubmit=function(t){if(!this.length){a("ajaxSubmit: skipping submit process - no element selected");return this}if(typeof t=="function"){t={success:t}}var h=this.attr("action");var d=(typeof h==="string")?b.trim(h):"";if(d){d=(d.match(/^([^#]+)/)||[])[1]}d=d||window.location.href||"";t=b.extend(true,{url:d,success:b.ajaxSettings.success,type:this[0].getAttribute("method")||"GET",iframeSrc:/^https/i.test(window.location.href||"")?"javascript:false":"about:blank"},t);var u={};this.trigger("form-pre-serialize",[this,t,u]);if(u.veto){a("ajaxSubmit: submit vetoed via form-pre-serialize trigger");return this}if(t.beforeSerialize&&t.beforeSerialize(this,t)===false){a("ajaxSubmit: submit aborted via beforeSerialize callback");return this}var f,p,m=this.formToArray(t.semantic);if(t.data){t.extraData=t.data;for(f in t.data){if(t.data[f] instanceof Array){for(var i in t.data[f]){m.push({name:f,value:t.data[f][i]})}}else{p=t.data[f];p=b.isFunction(p)?p():p;m.push({name:f,value:p})}}}if(t.beforeSubmit&&t.beforeSubmit(m,this,t)===false){a("ajaxSubmit: submit aborted via beforeSubmit callback");return this}this.trigger("form-submit-validate",[m,this,t,u]);if(u.veto){a("ajaxSubmit: submit vetoed via form-submit-validate trigger");return this}var c=b.param(m);if(t.type.toUpperCase()=="GET"){t.url+=(t.url.indexOf("?")>=0?"&":"?")+c;t.data=null}else{t.data=c}var s=this,l=[];if(t.resetForm){l.push(function(){s.resetForm()})}if(t.clearForm){l.push(function(){s.clearForm()})}if(!t.dataType&&t.target){var r=t.success||function(){};l.push(function(n){var k=t.replaceTarget?"replaceWith":"html";b(t.target)[k](n).each(r,arguments)})}else{if(t.success){l.push(t.success)}}t.success=function(w,n,x){var v=t.context||t;for(var q=0,k=l.length;q<k;q++){l[q].apply(v,[w,n,x||s,s])}};var g=b("input:file",this).length>0;var e="multipart/form-data";var j=(s.attr("enctype")==e||s.attr("encoding")==e);if(t.iframe!==false&&(g||t.iframe||j)){if(t.closeKeepAlive){b.get(t.closeKeepAlive,o)}else{o()}}else{b.ajax(t)}this.trigger("form-submit-notify",[this,t]);return this;function o(){var v=s[0];if(b(":input[name=submit],:input[id=submit]",v).length){alert('Error: Form elements must not have name or id of "submit".');return}var D=b.extend(true,{},b.ajaxSettings,t);D.context=D.context||D;var G="jqFormIO"+(new Date().getTime()),A="_"+G;var x=b('<iframe id="'+G+'" name="'+G+'" src="'+D.iframeSrc+'" />');var B=x[0];x.css({position:"absolute",top:"-1000px",left:"-1000px"});var y={aborted:0,responseText:null,responseXML:null,status:0,statusText:"n/a",getAllResponseHeaders:function(){},getResponseHeader:function(){},setRequestHeader:function(){},abort:function(n){var O=(n==="timeout"?"timeout":"aborted");a("aborting upload... "+O);this.aborted=1;x.attr("src",D.iframeSrc);y.error=O;D.error&&D.error.call(D.context,y,O,O);K&&b.event.trigger("ajaxError",[y,D,O]);D.complete&&D.complete.call(D.context,y,O)}};var K=D.global;if(K&&!b.active++){b.event.trigger("ajaxStart")}if(K){b.event.trigger("ajaxSend",[y,D])}if(D.beforeSend&&D.beforeSend.call(D.context,y,D)===false){if(D.global){b.active--}return}if(y.aborted){return}var J=0,C;var z=v.clk;if(z){var H=z.name;if(H&&!z.disabled){D.extraData=D.extraData||{};D.extraData[H]=z.value;if(z.type=="image"){D.extraData[H+".x"]=v.clk_x;D.extraData[H+".y"]=v.clk_y}}}function I(){var Q=s.attr("target"),O=s.attr("action");v.setAttribute("target",G);if(v.getAttribute("method")!="POST"){v.setAttribute("method","POST")}if(v.getAttribute("action")!=D.url){v.setAttribute("action",D.url)}if(!D.skipEncodingOverride){s.attr({encoding:"multipart/form-data",enctype:"multipart/form-data"})}if(D.timeout){C=setTimeout(function(){J=true;F(true)},D.timeout)}var P=[];try{if(D.extraData){for(var R in D.extraData){P.push(b('<input type="hidden" name="'+R+'" value="'+D.extraData[R]+'" />').appendTo(v)[0])}}x.appendTo("body");B.attachEvent?B.attachEvent("onload",F):B.addEventListener("load",F,false);v.submit()}finally{v.setAttribute("action",O);if(Q){v.setAttribute("target",Q)}else{s.removeAttr("target")}b(P).remove()}}if(D.forceSync){I()}else{setTimeout(I,10)}var M,N,L=50,w;function F(T){if(y.aborted||w){return}if(T===true&&y){y.abort("timeout");return}var S=B.contentWindow?B.contentWindow.document:B.contentDocument?B.contentDocument:B.document;if(!S||S.location.href==D.iframeSrc){if(!J){return}}B.detachEvent?B.detachEvent("onload",F):B.removeEventListener("load",F,false);var P=true;try{if(J){throw"timeout"}var U=D.dataType=="xml"||S.XMLDocument||b.isXMLDoc(S);a("isXml="+U);if(!U&&window.opera&&(S.body==null||S.body.innerHTML=="")){if(--L){a("requeing onLoad callback, DOM not available");setTimeout(F,250);return}}y.responseText=S.body?S.body.innerHTML:S.documentElement?S.documentElement.innerHTML:null;y.responseXML=S.XMLDocument?S.XMLDocument:S;if(U){D.dataType="xml"}y.getResponseHeader=function(W){var V={"content-type":D.dataType};return V[W]};var R=/(json|script|text)/.test(D.dataType);if(R||D.textarea){var O=S.getElementsByTagName("textarea")[0];if(O){y.responseText=O.value}else{if(R){var Q=S.getElementsByTagName("pre")[0];var n=S.getElementsByTagName("body")[0];if(Q){y.responseText=Q.textContent}else{if(n){y.responseText=n.innerHTML}}}}}else{if(D.dataType=="xml"&&!y.responseXML&&y.responseText!=null){y.responseXML=E(y.responseText)}}M=k(y,D.dataType,D)}catch(T){a("error caught:",T);P=false;y.error=T;D.error&&D.error.call(D.context,y,"error",T);K&&b.event.trigger("ajaxError",[y,D,T])}if(y.aborted){a("upload aborted");P=false}if(P){D.success&&D.success.call(D.context,M,"success",y);K&&b.event.trigger("ajaxSuccess",[y,D])}K&&b.event.trigger("ajaxComplete",[y,D]);if(K&&!--b.active){b.event.trigger("ajaxStop")}D.complete&&D.complete.call(D.context,y,P?"success":"error");w=true;if(D.timeout){clearTimeout(C)}setTimeout(function(){x.removeData("form-plugin-onload");x.remove();y.responseXML=null},100)}var E=b.parseXML||function(n,O){if(window.ActiveXObject){O=new ActiveXObject("Microsoft.XMLDOM");O.async="false";O.loadXML(n)}else{O=(new DOMParser()).parseFromString(n,"text/xml")}return(O&&O.documentElement&&O.documentElement.nodeName!="parsererror")?O:null};var q=b.parseJSON||function(n){return window["eval"]("("+n+")")};var k=function(S,Q,P){var O=S.getResponseHeader("content-type")||"",n=Q==="xml"||!Q&&O.indexOf("xml")>=0,R=n?S.responseXML:S.responseText;if(n&&R.documentElement.nodeName==="parsererror"){b.error&&b.error("parsererror")}if(P&&P.dataFilter){R=P.dataFilter(R,Q)}if(typeof R==="string"){if(Q==="json"||!Q&&O.indexOf("json")>=0){R=q(R)}else{if(Q==="script"||!Q&&O.indexOf("javascript")>=0){b.globalEval(R)}}}return R}}};b.fn.ajaxForm=function(c){if(this.length===0){var d={s:this.selector,c:this.context};if(!b.isReady&&d.s){a("DOM not ready, queuing ajaxForm");b(function(){b(d.s,d.c).ajaxForm(c)});return this}a("terminating; zero elements found by selector"+(b.isReady?"":" (DOM not ready)"));return this}return this.ajaxFormUnbind().bind("submit.form-plugin",function(f){if(!f.isDefaultPrevented()){f.preventDefault();b(this).ajaxSubmit(c)}}).bind("click.form-plugin",function(j){var i=j.target;var g=b(i);if(!(g.is(":submit,input:image"))){var f=g.closest(":submit");if(f.length==0){return}i=f[0]}var h=this;h.clk=i;if(i.type=="image"){if(j.offsetX!=undefined){h.clk_x=j.offsetX;h.clk_y=j.offsetY}else{if(typeof b.fn.offset=="function"){var k=g.offset();h.clk_x=j.pageX-k.left;h.clk_y=j.pageY-k.top}else{h.clk_x=j.pageX-i.offsetLeft;h.clk_y=j.pageY-i.offsetTop}}}setTimeout(function(){h.clk=h.clk_x=h.clk_y=null},100)})};b.fn.ajaxFormUnbind=function(){return this.unbind("submit.form-plugin click.form-plugin")};b.fn.formToArray=function(q){var p=[];if(this.length===0){return p}var d=this[0];var g=q?d.getElementsByTagName("*"):d.elements;if(!g){return p}var k,h,f,r,e,m,c;for(k=0,m=g.length;k<m;k++){e=g[k];f=e.name;if(!f){continue}if(q&&d.clk&&e.type=="image"){if(!e.disabled&&d.clk==e){p.push({name:f,value:b(e).val()});p.push({name:f+".x",value:d.clk_x},{name:f+".y",value:d.clk_y})}continue}r=b.fieldValue(e,true);if(r&&r.constructor==Array){for(h=0,c=r.length;h<c;h++){p.push({name:f,value:r[h]})}}else{if(r!==null&&typeof r!="undefined"){p.push({name:f,value:r})}}}if(!q&&d.clk){var l=b(d.clk),o=l[0];f=o.name;if(f&&!o.disabled&&o.type=="image"){p.push({name:f,value:l.val()});p.push({name:f+".x",value:d.clk_x},{name:f+".y",value:d.clk_y})}}return p};b.fn.formSerialize=function(c){return b.param(this.formToArray(c))};b.fn.fieldSerialize=function(d){var c=[];this.each(function(){var h=this.name;if(!h){return}var f=b.fieldValue(this,d);if(f&&f.constructor==Array){for(var g=0,e=f.length;g<e;g++){c.push({name:h,value:f[g]})}}else{if(f!==null&&typeof f!="undefined"){c.push({name:this.name,value:f})}}});return b.param(c)};b.fn.fieldValue=function(h){for(var g=[],e=0,c=this.length;e<c;e++){var f=this[e];var d=b.fieldValue(f,h);if(d===null||typeof d=="undefined"||(d.constructor==Array&&!d.length)){continue}d.constructor==Array?b.merge(g,d):g.push(d)}return g};b.fieldValue=function(c,j){var e=c.name,p=c.type,q=c.tagName.toLowerCase();if(j===undefined){j=true}if(j&&(!e||c.disabled||p=="reset"||p=="button"||(p=="checkbox"||p=="radio")&&!c.checked||(p=="submit"||p=="image")&&c.form&&c.form.clk!=c||q=="select"&&c.selectedIndex==-1)){return null}if(q=="select"){var k=c.selectedIndex;if(k<0){return null}var m=[],d=c.options;var g=(p=="select-one");var l=(g?k+1:d.length);for(var f=(g?k:0);f<l;f++){var h=d[f];if(h.selected){var o=h.value;if(!o){o=(h.attributes&&h.attributes.value&&!(h.attributes.value.specified))?h.text:h.value}if(g){return o}m.push(o)}}return m}return b(c).val()};b.fn.clearForm=function(){return this.each(function(){b("input,select,textarea",this).clearFields()})};b.fn.clearFields=b.fn.clearInputs=function(){return this.each(function(){var d=this.type,c=this.tagName.toLowerCase();if(d=="text"||d=="password"||c=="textarea"){this.value=""}else{if(d=="checkbox"||d=="radio"){this.checked=false}else{if(c=="select"){this.selectedIndex=-1}}}})};b.fn.resetForm=function(){return this.each(function(){if(typeof this.reset=="function"||(typeof this.reset=="object"&&!this.reset.nodeType)){this.reset()}})};b.fn.enable=function(c){if(c===undefined){c=true}return this.each(function(){this.disabled=!c})};b.fn.selected=function(c){if(c===undefined){c=true}return this.each(function(){var d=this.type;if(d=="checkbox"||d=="radio"){this.checked=c}else{if(this.tagName.toLowerCase()=="option"){var e=b(this).parent("select");if(c&&e[0]&&e[0].type=="select-one"){e.find("option").selected(false)}this.selected=c}}})};function a(){if(b.fn.ajaxSubmit.debug){var c="[jquery.form] "+Array.prototype.join.call(arguments,"");if(window.console&&window.console.log){window.console.log(c)}else{if(window.opera&&window.opera.postError){window.opera.postError(c)}}}}})(jQuery);
\ No newline at end of file