]> git.mxchange.org Git - quix0rs-gnu-social.git/blobdiff - js/jquery.form.js
Revert "Revert back to using document._importNode() for ajax posting"
[quix0rs-gnu-social.git] / js / jquery.form.js
index dde394270f13cabc96340a834235651863593e8c..936b847abe7bedc9ae44cf68cc75a48b1b94bf5c 100644 (file)
-/*
- * jQuery Form Plugin
- * version: 2.36 (07-NOV-2009)
- * @requires jQuery v1.2.6 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($) {
-
-/*
-       Usage Note:
-       -----------
-       Do not use both ajaxSubmit and ajaxForm on the same form.  These
-       functions are intended to be exclusive.  Use ajaxSubmit if you want
-       to bind your own submit handler to the form.  For example,
-
-       $(document).ready(function() {
-               $('#myForm').bind('submit', function() {
-                       $(this).ajaxSubmit({
-                               target: '#output'
-                       });
-                       return false; // <-- important!
-               });
-       });
-
-       Use ajaxForm when you want the plugin to manage all the event binding
-       for you.  For example,
-
-       $(document).ready(function() {
-               $('#myForm').ajaxForm({
-                       target: '#output'
-               });
-       });
-
-       When using ajaxForm, the ajaxSubmit function will be invoked for you
-       at the appropriate time.
-*/
-
-/**
- * ajaxSubmit() provides a mechanism for immediately submitting
- * an HTML form using AJAX.
- */
-$.fn.ajaxSubmit = function(options) {
-       // fast fail if nothing selected (http://dev.jquery.com/ticket/2752)
-       if (!this.length) {
-               log('ajaxSubmit: skipping submit process - no element selected');
-               return this;
-       }
-
-       if (typeof options == 'function')
-               options = { success: options };
-
-       var url = $.trim(this.attr('action'));
-       if (url) {
-               // clean url (don't include hash vaue)
-               url = (url.match(/^([^#]+)/)||[])[1];
-       }
-       url = url || window.location.href || '';
-
-       options = $.extend({
-               url:  url,
-               type: this.attr('method') || 'GET',
-               iframeSrc: /^https/i.test(window.location.href || '') ? 'javascript:false' : 'about:blank'
-       }, options || {});
-
-       // hook for manipulating the form data before it is extracted;
-       // convenient for use with rich editors like tinyMCE or FCKEditor
-       var veto = {};
-       this.trigger('form-pre-serialize', [this, options, veto]);
-       if (veto.veto) {
-               log('ajaxSubmit: submit vetoed via form-pre-serialize trigger');
-               return this;
-       }
-
-       // provide opportunity to alter form data before it is serialized
-       if (options.beforeSerialize && options.beforeSerialize(this, options) === false) {
-               log('ajaxSubmit: submit aborted via beforeSerialize callback');
-               return this;
-       }
-
-       var a = this.formToArray(options.semantic);
-       if (options.data) {
-               options.extraData = options.data;
-               for (var n in options.data) {
-                 if(options.data[n] instanceof Array) {
-                       for (var k in options.data[n])
-                         a.push( { name: n, value: options.data[n][k] } );
-                 }
-                 else
-                        a.push( { name: n, value: options.data[n] } );
-               }
-       }
-
-       // give pre-submit callback an opportunity to abort the submit
-       if (options.beforeSubmit && options.beforeSubmit(a, this, options) === false) {
-               log('ajaxSubmit: submit aborted via beforeSubmit callback');
-               return this;
-       }
-
-       // fire vetoable 'validate' event
-       this.trigger('form-submit-validate', [a, this, options, veto]);
-       if (veto.veto) {
-               log('ajaxSubmit: submit vetoed via form-submit-validate trigger');
-               return this;
-       }
-
-       var q = $.param(a);
-
-       if (options.type.toUpperCase() == 'GET') {
-               options.url += (options.url.indexOf('?') >= 0 ? '&' : '?') + q;
-               options.data = null;  // data is null for 'get'
-       }
-       else
-               options.data = q; // data is the query string for 'post'
-
-       var $form = this, callbacks = [];
-       if (options.resetForm) callbacks.push(function() { $form.resetForm(); });
-       if (options.clearForm) callbacks.push(function() { $form.clearForm(); });
-
-       // perform a load on the target only if dataType is not provided
-       if (!options.dataType && options.target) {
-               var oldSuccess = options.success || function(){};
-               callbacks.push(function(data) {
-                       $(options.target).html(data).each(oldSuccess, arguments);
-               });
-       }
-       else if (options.success)
-               callbacks.push(options.success);
-
-       options.success = function(data, status) {
-               for (var i=0, max=callbacks.length; i < max; i++)
-                       callbacks[i].apply(options, [data, status, $form]);
-       };
-
-       // are there files to upload?
-       var files = $('input:file', this).fieldValue();
-       var found = false;
-       for (var j=0; j < files.length; j++)
-               if (files[j])
-                       found = true;
-
-       var multipart = false;
-//     var mp = 'multipart/form-data';
-//     multipart = ($form.attr('enctype') == mp || $form.attr('encoding') == mp);
-
-       // options.iframe allows user to force iframe mode
-       // 06-NOV-09: now defaulting to iframe mode if file input is detected
-   if ((files.length && options.iframe !== false) || options.iframe || found || multipart) {
-          // hack to fix Safari hang (thanks to Tim Molendijk for this)
-          // see:  http://groups.google.com/group/jquery-dev/browse_thread/thread/36395b7ab510dd5d
-          if (options.closeKeepAlive)
-                  $.get(options.closeKeepAlive, fileUpload);
-          else
-                  fileUpload();
-          }
-   else
-          $.ajax(options);
-
-       // fire 'notify' event
-       this.trigger('form-submit-notify', [this, options]);
-       return this;
-
-
-       // private function for handling file uploads (hat tip to YAHOO!)
-       function fileUpload() {
-               var form = $form[0];
-
-               if ($(':input[name=submit]', form).length) {
-                       alert('Error: Form elements must not be named "submit".');
-                       return;
-               }
-
-               var opts = $.extend({}, $.ajaxSettings, options);
-               var s = $.extend(true, {}, $.extend(true, {}, $.ajaxSettings), opts);
-
-               var id = 'jqFormIO' + (new Date().getTime());
-               var $io = $('<iframe id="' + id + '" name="' + id + '" src="'+ opts.iframeSrc +'" />');
-               var io = $io[0];
-
-               $io.css({ position: 'absolute', top: '-1000px', left: '-1000px' });
-
-               var xhr = { // mock object
-                       aborted: 0,
-                       responseText: null,
-                       responseXML: null,
-                       status: 0,
-                       statusText: 'n/a',
-                       getAllResponseHeaders: function() {},
-                       getResponseHeader: function() {},
-                       setRequestHeader: function() {},
-                       abort: function() {
-                               this.aborted = 1;
-                               $io.attr('src', opts.iframeSrc); // abort op in progress
-                       }
-               };
-
-               var g = opts.global;
-               // trigger ajax global events so that activity/block indicators work like normal
-               if (g && ! $.active++) $.event.trigger("ajaxStart");
-               if (g) $.event.trigger("ajaxSend", [xhr, opts]);
-
-               if (s.beforeSend && s.beforeSend(xhr, s) === false) {
-                       s.global && $.active--;
-                       return;
-               }
-               if (xhr.aborted)
-                       return;
-
-               var cbInvoked = 0;
-               var timedOut = 0;
-
-               // add submitting element to data if we know it
-               var sub = form.clk;
-               if (sub) {
-                       var n = sub.name;
-                       if (n && !sub.disabled) {
-                               options.extraData = options.extraData || {};
-                               options.extraData[n] = sub.value;
-                               if (sub.type == "image") {
-                                       options.extraData[name+'.x'] = form.clk_x;
-                                       options.extraData[name+'.y'] = form.clk_y;
-                               }
-                       }
-               }
-
-               // take a breath so that pending repaints get some cpu time before the upload starts
-               setTimeout(function() {
-                       // make sure form attrs are set
-                       var t = $form.attr('target'), a = $form.attr('action');
-
-                       // update form attrs in IE friendly way
-                       form.setAttribute('target',id);
-                       if (form.getAttribute('method') != 'POST')
-                               form.setAttribute('method', 'POST');
-                       if (form.getAttribute('action') != opts.url)
-                               form.setAttribute('action', opts.url);
-
-                       // ie borks in some cases when setting encoding
-                       if (! options.skipEncodingOverride) {
-                               $form.attr({
-                                       encoding: 'multipart/form-data',
-                                       enctype:  'multipart/form-data'
-                               });
-                       }
-
-                       // support timout
-                       if (opts.timeout)
-                               setTimeout(function() { timedOut = true; cb(); }, opts.timeout);
-
-                       // add "extra" data to form if provided in options
-                       var extraInputs = [];
-                       try {
-                               if (options.extraData)
-                                       for (var n in options.extraData)
-                                               extraInputs.push(
-                                                       $('<input type="hidden" name="'+n+'" value="'+options.extraData[n]+'" />')
-                                                               .appendTo(form)[0]);
-
-                               // add iframe to doc and submit the form
-                               $io.appendTo('body');
-                               io.attachEvent ? io.attachEvent('onload', cb) : io.addEventListener('load', cb, false);
-                               form.submit();
-                       }
-                       finally {
-                               // reset attrs and remove "extra" input elements
-                               form.setAttribute('action',a);
-                               t ? form.setAttribute('target', t) : $form.removeAttr('target');
-                               $(extraInputs).remove();
-                       }
-               }, 10);
-
-               var domCheckCount = 50;
-
-               function cb() {
-                       if (cbInvoked++) return;
-
-                       io.detachEvent ? io.detachEvent('onload', cb) : io.removeEventListener('load', cb, false);
-
-                       var ok = true;
-                       try {
-                               if (timedOut) throw 'timeout';
-                               // extract the server response from the iframe
-                               var data, doc;
-
-                               doc = io.contentWindow ? io.contentWindow.document : io.contentDocument ? io.contentDocument : io.document;
-                               
-                               var isXml = opts.dataType == 'xml' || doc.XMLDocument || $.isXMLDoc(doc);
-                               log('isXml='+isXml);
-                               if (!isXml && (doc.body == null || doc.body.innerHTML == '')) {
-                                       if (--domCheckCount) {
-                                               // in some browsers (Opera) the iframe DOM is not always traversable when
-                                               // the onload callback fires, so we loop a bit to accommodate
-                                               cbInvoked = 0;
-                                               setTimeout(cb, 100);
-                                               return;
-                                       }
-                                       log('Could not access iframe DOM after 50 tries.');
-                                       return;
-                               }
-
-                               xhr.responseText = doc.body ? doc.body.innerHTML : null;
-                               xhr.responseXML = doc.XMLDocument ? doc.XMLDocument : doc;
-                               xhr.getResponseHeader = function(header){
-                                       var headers = {'content-type': opts.dataType};
-                                       return headers[header];
-                               };
-
-                               if (opts.dataType == 'json' || opts.dataType == 'script') {
-                                       // see if user embedded response in textarea
-                                       var ta = doc.getElementsByTagName('textarea')[0];
-                                       if (ta)
-                                               xhr.responseText = ta.value;
-                                       else {
-                                               // account for browsers injecting pre around json response
-                                               var pre = doc.getElementsByTagName('pre')[0];
-                                               if (pre)
-                                                       xhr.responseText = pre.innerHTML;
-                                       }                         
-                               }
-                               else if (opts.dataType == 'xml' && !xhr.responseXML && xhr.responseText != null) {
-                                       xhr.responseXML = toXml(xhr.responseText);
-                               }
-                               data = $.httpData(xhr, opts.dataType);
-                       }
-                       catch(e){
-                               ok = false;
-                               $.handleError(opts, xhr, 'error', e);
-                       }
-
-                       // ordering of these callbacks/triggers is odd, but that's how $.ajax does it
-                       if (ok) {
-                               opts.success(data, 'success');
-                               if (g) $.event.trigger("ajaxSuccess", [xhr, opts]);
-                       }
-                       if (g) $.event.trigger("ajaxComplete", [xhr, opts]);
-                       if (g && ! --$.active) $.event.trigger("ajaxStop");
-                       if (opts.complete) opts.complete(xhr, ok ? 'success' : 'error');
-
-                       // clean up
-                       setTimeout(function() {
-                               $io.remove();
-                               xhr.responseXML = null;
-                       }, 100);
-               };
-
-               function toXml(s, doc) {
-                       if (window.ActiveXObject) {
-                               doc = new ActiveXObject('Microsoft.XMLDOM');
-                               doc.async = 'false';
-                               doc.loadXML(s);
-                       }
-                       else
-                               doc = (new DOMParser()).parseFromString(s, 'text/xml');
-                       return (doc && doc.documentElement && doc.documentElement.tagName != 'parsererror') ? doc : null;
-               };
-       };
-};
-
-/**
- * ajaxForm() provides a mechanism for fully automating form submission.
- *
- * The advantages of using this method instead of ajaxSubmit() are:
- *
- * 1: This method will include coordinates for <input type="image" /> elements (if the element
- *     is used to submit the form).
- * 2. This method will include the submit element's name/value data (for the element that was
- *     used to submit the form).
- * 3. This method binds the submit() method to the form for you.
- *
- * The options argument for ajaxForm works exactly as it does for ajaxSubmit.  ajaxForm merely
- * passes the options argument along after properly binding events for submit elements and
- * the form itself.
- */
-$.fn.ajaxForm = function(options) {
-       return this.ajaxFormUnbind().bind('submit.form-plugin', function() {
-               $(this).ajaxSubmit(options);
-               return false;
-       }).bind('click.form-plugin', function(e) {
-               var target = e.target;
-               var $el = $(target);
-               if (!($el.is(":submit,input:image"))) {
-                       // is this a child element of the submit el?  (ex: a span within a button)
-                       var t = $el.closest(':submit');
-                       if (t.length == 0)
-                               return;
-                       target = t[0];
-               }
-               var form = this;
-               form.clk = target;
-               if (target.type == 'image') {
-                       if (e.offsetX != undefined) {
-                               form.clk_x = e.offsetX;
-                               form.clk_y = e.offsetY;
-                       } else if (typeof $.fn.offset == 'function') { // try to use dimensions plugin
-                               var offset = $el.offset();
-                               form.clk_x = e.pageX - offset.left;
-                               form.clk_y = e.pageY - offset.top;
-                       } else {
-                               form.clk_x = e.pageX - target.offsetLeft;
-                               form.clk_y = e.pageY - target.offsetTop;
-                       }
-               }
-               // clear form vars
-               setTimeout(function() { form.clk = form.clk_x = form.clk_y = null; }, 100);
-       });
-};
-
-// ajaxFormUnbind unbinds the event handlers that were bound by ajaxForm
-$.fn.ajaxFormUnbind = function() {
-       return this.unbind('submit.form-plugin click.form-plugin');
-};
-
-/**
- * formToArray() gathers form element data into an array of objects that can
- * be passed to any of the following ajax functions: $.get, $.post, or load.
- * Each object in the array has both a 'name' and 'value' property.  An example of
- * an array for a simple login form might be:
- *
- * [ { name: 'username', value: 'jresig' }, { name: 'password', value: 'secret' } ]
- *
- * It is this array that is passed to pre-submit callback functions provided to the
- * ajaxSubmit() and ajaxForm() methods.
- */
-$.fn.formToArray = function(semantic) {
-       var a = [];
-       if (this.length == 0) return a;
-
-       var form = this[0];
-       var els = semantic ? form.getElementsByTagName('*') : form.elements;
-       if (!els) return a;
-       for(var i=0, max=els.length; i < max; i++) {
-               var el = els[i];
-               var n = el.name;
-               if (!n) continue;
-
-               if (semantic && form.clk && el.type == "image") {
-                       // handle image inputs on the fly when semantic == true
-                       if(!el.disabled && form.clk == el) {
-                               a.push({name: n, value: $(el).val()});
-                               a.push({name: n+'.x', value: form.clk_x}, {name: n+'.y', value: form.clk_y});
-                       }
-                       continue;
-               }
-
-               var v = $.fieldValue(el, true);
-               if (v && v.constructor == Array) {
-                       for(var j=0, jmax=v.length; j < jmax; j++)
-                               a.push({name: n, value: v[j]});
-               }
-               else if (v !== null && typeof v != 'undefined')
-                       a.push({name: n, value: v});
-       }
-
-       if (!semantic && form.clk) {
-               // input type=='image' are not found in elements array! handle it here
-               var $input = $(form.clk), input = $input[0], n = input.name;
-               if (n && !input.disabled && input.type == 'image') {
-                       a.push({name: n, value: $input.val()});
-                       a.push({name: n+'.x', value: form.clk_x}, {name: n+'.y', value: form.clk_y});
-               }
-       }
-       return a;
-};
-
-/**
- * Serializes form data into a 'submittable' string. This method will return a string
- * in the format: name1=value1&amp;name2=value2
- */
-$.fn.formSerialize = function(semantic) {
-       //hand off to jQuery.param for proper encoding
-       return $.param(this.formToArray(semantic));
-};
-
-/**
- * Serializes all field elements in the jQuery object into a query string.
- * This method will return a string in the format: name1=value1&amp;name2=value2
- */
-$.fn.fieldSerialize = function(successful) {
-       var a = [];
-       this.each(function() {
-               var n = this.name;
-               if (!n) return;
-               var v = $.fieldValue(this, successful);
-               if (v && v.constructor == Array) {
-                       for (var i=0,max=v.length; i < max; i++)
-                               a.push({name: n, value: v[i]});
-               }
-               else if (v !== null && typeof v != 'undefined')
-                       a.push({name: this.name, value: v});
-       });
-       //hand off to jQuery.param for proper encoding
-       return $.param(a);
-};
-
-/**
- * Returns the value(s) of the element in the matched set.  For example, consider the following form:
- *
- *  <form><fieldset>
- *       <input name="A" type="text" />
- *       <input name="A" type="text" />
- *       <input name="B" type="checkbox" value="B1" />
- *       <input name="B" type="checkbox" value="B2"/>
- *       <input name="C" type="radio" value="C1" />
- *       <input name="C" type="radio" value="C2" />
- *  </fieldset></form>
- *
- *  var v = $(':text').fieldValue();
- *  // if no values are entered into the text inputs
- *  v == ['','']
- *  // if values entered into the text inputs are 'foo' and 'bar'
- *  v == ['foo','bar']
- *
- *  var v = $(':checkbox').fieldValue();
- *  // if neither checkbox is checked
- *  v === undefined
- *  // if both checkboxes are checked
- *  v == ['B1', 'B2']
- *
- *  var v = $(':radio').fieldValue();
- *  // if neither radio is checked
- *  v === undefined
- *  // if first radio is checked
- *  v == ['C1']
- *
- * The successful argument controls whether or not the field element must be 'successful'
- * (per http://www.w3.org/TR/html4/interact/forms.html#successful-controls).
- * The default value of the successful argument is true.  If this value is false the value(s)
- * for each element is returned.
- *
- * Note: This method *always* returns an array.  If no valid value can be determined the
- *        array will be empty, otherwise it will contain one or more values.
- */
-$.fn.fieldValue = function(successful) {
-       for (var val=[], i=0, max=this.length; i < max; i++) {
-               var el = this[i];
-               var v = $.fieldValue(el, successful);
-               if (v === null || typeof v == 'undefined' || (v.constructor == Array && !v.length))
-                       continue;
-               v.constructor == Array ? $.merge(val, v) : val.push(v);
-       }
-       return val;
-};
-
-/**
- * Returns the value of the field element.
- */
-$.fieldValue = function(el, successful) {
-       var n = el.name, t = el.type, tag = el.tagName.toLowerCase();
-       if (typeof successful == 'undefined') successful = true;
-
-       if (successful && (!n || el.disabled || t == 'reset' || t == 'button' ||
-               (t == 'checkbox' || t == 'radio') && !el.checked ||
-               (t == 'submit' || t == 'image') && el.form && el.form.clk != el ||
-               tag == 'select' && el.selectedIndex == -1))
-                       return null;
-
-       if (tag == 'select') {
-               var index = el.selectedIndex;
-               if (index < 0) return null;
-               var a = [], ops = el.options;
-               var one = (t == 'select-one');
-               var max = (one ? index+1 : ops.length);
-               for(var i=(one ? index : 0); i < max; i++) {
-                       var op = ops[i];
-                       if (op.selected) {
-                               var v = op.value;
-                               if (!v) // extra pain for IE...
-                                       v = (op.attributes && op.attributes['value'] && !(op.attributes['value'].specified)) ? op.text : op.value;
-                               if (one) return v;
-                               a.push(v);
-                       }
-               }
-               return a;
-       }
-       return el.value;
-};
-
-/**
- * Clears the form data.  Takes the following actions on the form's input fields:
- *  - input text fields will have their 'value' property set to the empty string
- *  - select elements will have their 'selectedIndex' property set to -1
- *  - checkbox and radio inputs will have their 'checked' property set to false
- *  - inputs of type submit, button, reset, and hidden will *not* be effected
- *  - button elements will *not* be effected
- */
-$.fn.clearForm = function() {
-       return this.each(function() {
-               $('input,select,textarea', this).clearFields();
-       });
-};
-
-/**
- * Clears the selected form elements.
- */
-$.fn.clearFields = $.fn.clearInputs = function() {
-       return this.each(function() {
-               var t = this.type, tag = this.tagName.toLowerCase();
-               if (t == 'text' || t == 'password' || tag == 'textarea')
-                       this.value = '';
-               else if (t == 'checkbox' || t == 'radio')
-                       this.checked = false;
-               else if (tag == 'select')
-                       this.selectedIndex = -1;
-       });
-};
-
-/**
- * Resets the form data.  Causes all form elements to be reset to their original value.
- */
-$.fn.resetForm = function() {
-       return this.each(function() {
-               // guard against an input with the name of 'reset'
-               // note that IE reports the reset function as an 'object'
-               if (typeof this.reset == 'function' || (typeof this.reset == 'object' && !this.reset.nodeType))
-                       this.reset();
-       });
-};
-
-/**
- * Enables or disables any matching elements.
- */
-$.fn.enable = function(b) {
-       if (b == undefined) b = true;
-       return this.each(function() {
-               this.disabled = !b;
-       });
-};
-
-/**
- * Checks/unchecks any matching checkboxes or radio buttons and
- * selects/deselects and matching option elements.
- */
-$.fn.selected = function(select) {
-       if (select == undefined) select = true;
-       return this.each(function() {
-               var t = this.type;
-               if (t == 'checkbox' || t == 'radio')
-                       this.checked = select;
-               else if (this.tagName.toLowerCase() == 'option') {
-                       var $sel = $(this).parent('select');
-                       if (select && $sel[0] && $sel[0].type == 'select-one') {
-                               // deselect all other options
-                               $sel.find('option').selected(false);
-                       }
-                       this.selected = select;
-               }
-       });
-};
-
-// helper fn for console logging
-// set $.fn.ajaxSubmit.debug to true to enable debug logging
-function log() {
-       if ($.fn.ajaxSubmit.debug && window.console && window.console.log)
-               window.console.log('[jquery.form] ' + Array.prototype.join.call(arguments,''));
-};
-
-})(jQuery);
+/*\r
+ * jQuery Form Plugin\r
+ * version: 2.17 (06-NOV-2008)\r
+ * @requires jQuery v1.2.2 or later\r
+ *\r
+ * Examples and documentation at: http://malsup.com/jquery/form/\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
+ */\r
+;(function($) {\r
+\r
+/*\r
+    Usage Note:  \r
+    -----------\r
+    Do not use both ajaxSubmit and ajaxForm on the same form.  These\r
+    functions are intended to be exclusive.  Use ajaxSubmit if you want\r
+    to bind your own submit handler to the form.  For example,\r
+\r
+    $(document).ready(function() {\r
+        $('#myForm').bind('submit', function() {\r
+            $(this).ajaxSubmit({\r
+                target: '#output'\r
+            });\r
+            return false; // <-- important!\r
+        });\r
+    });\r
+\r
+    Use ajaxForm when you want the plugin to manage all the event binding\r
+    for you.  For example,\r
+\r
+    $(document).ready(function() {\r
+        $('#myForm').ajaxForm({\r
+            target: '#output'\r
+        });\r
+    });\r
+        \r
+    When using ajaxForm, the ajaxSubmit function will be invoked for you\r
+    at the appropriate time.  \r
+*/\r
+\r
+/**\r
+ * ajaxSubmit() provides a mechanism for immediately submitting \r
+ * an HTML form using AJAX.\r
+ */\r
+$.fn.ajaxSubmit = function(options) {\r
+    // fast fail if nothing selected (http://dev.jquery.com/ticket/2752)\r
+    if (!this.length) {\r
+        log('ajaxSubmit: skipping submit process - no element selected');\r
+        return this;\r
+    }\r
+\r
+    if (typeof options == 'function')\r
+        options = { success: options };\r
+\r
+    options = $.extend({\r
+        url:  this.attr('action') || window.location.toString(),\r
+        type: this.attr('method') || 'GET'\r
+    }, options || {});\r
+\r
+    // hook for manipulating the form data before it is extracted;\r
+    // convenient for use with rich editors like tinyMCE or FCKEditor\r
+    var veto = {};\r
+    this.trigger('form-pre-serialize', [this, options, veto]);\r
+    if (veto.veto) {\r
+        log('ajaxSubmit: submit vetoed via form-pre-serialize trigger');\r
+        return this;\r
+    }\r
+\r
+    // provide opportunity to alter form data before it is serialized\r
+    if (options.beforeSerialize && options.beforeSerialize(this, options) === false) {\r
+        log('ajaxSubmit: submit aborted via beforeSerialize callback');\r
+        return this;\r
+    }    \r
+   \r
+    var a = this.formToArray(options.semantic);\r
+    if (options.data) {\r
+        options.extraData = options.data;\r
+        for (var n in options.data) {\r
+          if(options.data[n] instanceof Array) {\r
+            for (var k in options.data[n])\r
+              a.push( { name: n, value: options.data[n][k] } )\r
+          }  \r
+          else\r
+             a.push( { name: n, value: options.data[n] } );\r
+        }\r
+    }\r
+\r
+    // give pre-submit callback an opportunity to abort the submit\r
+    if (options.beforeSubmit && options.beforeSubmit(a, this, options) === false) {\r
+        log('ajaxSubmit: submit aborted via beforeSubmit callback');\r
+        return this;\r
+    }    \r
+\r
+    // fire vetoable 'validate' event\r
+    this.trigger('form-submit-validate', [a, this, options, veto]);\r
+    if (veto.veto) {\r
+        log('ajaxSubmit: submit vetoed via form-submit-validate trigger');\r
+        return this;\r
+    }    \r
+\r
+    var q = $.param(a);\r
+\r
+    if (options.type.toUpperCase() == 'GET') {\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) {\r
+            $(options.target).html(data).each(oldSuccess, arguments);\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].apply(options, [data, status, $form]);\r
+    };\r
+\r
+    // are there files to upload?\r
+    var files = $('input:file', this).fieldValue();\r
+    var found = false;\r
+    for (var j=0; j < files.length; j++)\r
+        if (files[j])\r
+            found = true;\r
+\r
+    // options.iframe allows user to force iframe mode\r
+   if (options.iframe || found) { \r
+       // hack to fix Safari hang (thanks to Tim Molendijk for this)\r
+       // see:  http://groups.google.com/group/jquery-dev/browse_thread/thread/36395b7ab510dd5d\r
+       if ($.browser.safari && options.closeKeepAlive)\r
+           $.get(options.closeKeepAlive, fileUpload);\r
+       else\r
+           fileUpload();\r
+       }\r
+   else\r
+       $.ajax(options);\r
+\r
+    // fire 'notify' event\r
+    this.trigger('form-submit-notify', [this, options]);\r
+    return this;\r
+\r
+\r
+    // private function for handling file uploads (hat tip to YAHOO!)\r
+    function fileUpload() {\r
+        var form = $form[0];\r
+        \r
+        if ($(':input[name=submit]', form).length) {\r
+            alert('Error: Form elements must not be named "submit".');\r
+            return;\r
+        }\r
+        \r
+        var opts = $.extend({}, $.ajaxSettings, options);\r
+               var s = jQuery.extend(true, {}, $.extend(true, {}, $.ajaxSettings), opts);\r
+\r
+        var id = 'jqFormIO' + (new Date().getTime());\r
+        var $io = $('<iframe id="' + id + '" name="' + id + '" />');\r
+        var io = $io[0];\r
+\r
+        if ($.browser.msie || $.browser.opera) \r
+            io.src = 'javascript:false;document.write("");';\r
+        $io.css({ position: 'absolute', top: '-1000px', left: '-1000px' });\r
+\r
+        var xhr = { // mock object\r
+            aborted: 0,\r
+            responseText: null,\r
+            responseXML: null,\r
+            status: 0,\r
+            statusText: 'n/a',\r
+            getAllResponseHeaders: function() {},\r
+            getResponseHeader: function() {},\r
+            setRequestHeader: function() {},\r
+            abort: function() { \r
+                this.aborted = 1; \r
+                $io.attr('src','about:blank'); // abort op in progress\r
+            }\r
+        };\r
+\r
+        var g = opts.global;\r
+        // trigger ajax global events so that activity/block indicators work like normal\r
+        if (g && ! $.active++) $.event.trigger("ajaxStart");\r
+        if (g) $.event.trigger("ajaxSend", [xhr, opts]);\r
+\r
+               if (s.beforeSend && s.beforeSend(xhr, s) === false) {\r
+                       s.global && jQuery.active--;\r
+                       return;\r
+        }\r
+        if (xhr.aborted)\r
+            return;\r
+        \r
+        var cbInvoked = 0;\r
+        var timedOut = 0;\r
+\r
+        // add submitting element to data if we know it\r
+        var sub = form.clk;\r
+        if (sub) {\r
+            var n = sub.name;\r
+            if (n && !sub.disabled) {\r
+                options.extraData = options.extraData || {};\r
+                options.extraData[n] = sub.value;\r
+                if (sub.type == "image") {\r
+                    options.extraData[name+'.x'] = form.clk_x;\r
+                    options.extraData[name+'.y'] = form.clk_y;\r
+                }\r
+            }\r
+        }\r
+\r
+        // take a breath so that pending repaints get some cpu time before the upload starts\r
+        setTimeout(function() {\r
+            // make sure form attrs are set\r
+            var t = $form.attr('target'), a = $form.attr('action');\r
+            $form.attr({\r
+                target:   id,\r
+                method:   'POST',\r
+                action:   opts.url\r
+            });\r
+            \r
+            // ie borks in some cases when setting encoding\r
+            if (! options.skipEncodingOverride) {\r
+                $form.attr({\r
+                    encoding: 'multipart/form-data',\r
+                    enctype:  'multipart/form-data'\r
+                });\r
+            }\r
+\r
+            // support timout\r
+            if (opts.timeout)\r
+                setTimeout(function() { timedOut = true; cb(); }, opts.timeout);\r
+\r
+            // add "extra" data to form if provided in options\r
+            var extraInputs = [];\r
+            try {\r
+                if (options.extraData)\r
+                    for (var n in options.extraData)\r
+                        extraInputs.push(\r
+                            $('<input type="hidden" name="'+n+'" value="'+options.extraData[n]+'" />')\r
+                                .appendTo(form)[0]);\r
+            \r
+                // add iframe to doc and submit the form\r
+                $io.appendTo('body');\r
+                io.attachEvent ? io.attachEvent('onload', cb) : io.addEventListener('load', cb, false);\r
+                form.submit();\r
+            }\r
+            finally {\r
+                // reset attrs and remove "extra" input elements\r
+                $form.attr('action', a);\r
+                t ? $form.attr('target', t) : $form.removeAttr('target');\r
+                $(extraInputs).remove();\r
+            }\r
+        }, 10);\r
+\r
+        function cb() {\r
+            if (cbInvoked++) return;\r
+            \r
+            io.detachEvent ? io.detachEvent('onload', cb) : io.removeEventListener('load', cb, false);\r
+\r
+            var operaHack = 0;\r
+            var ok = true;\r
+            try {\r
+                if (timedOut) throw 'timeout';\r
+                // extract the server response from the iframe\r
+                var data, doc;\r
+\r
+                doc = io.contentWindow ? io.contentWindow.document : io.contentDocument ? io.contentDocument : io.document;\r
+                \r
+                if (doc.body == null && !operaHack && $.browser.opera) {\r
+                    // In Opera 9.2.x the iframe DOM is not always traversable when\r
+                    // the onload callback fires so we give Opera 100ms to right itself\r
+                    operaHack = 1;\r
+                    cbInvoked--;\r
+                    setTimeout(cb, 100);\r
+                    return;\r
+                }\r
+                \r
+                xhr.responseText = doc.body ? doc.body.innerHTML : null;\r
+                xhr.responseXML = doc.XMLDocument ? doc.XMLDocument : doc;\r
+                xhr.getResponseHeader = function(header){\r
+                    var headers = {'content-type': opts.dataType};\r
+                    return headers[header];\r
+                };\r
+\r
+                if (opts.dataType == 'json' || opts.dataType == 'script') {\r
+                    var ta = doc.getElementsByTagName('textarea')[0];\r
+                    xhr.responseText = ta ? ta.value : xhr.responseText;\r
+                }\r
+                else if (opts.dataType == 'xml' && !xhr.responseXML && xhr.responseText != null) {\r
+                    xhr.responseXML = toXml(xhr.responseText);\r
+                }\r
+                data = $.httpData(xhr, opts.dataType);\r
+            }\r
+            catch(e){\r
+                ok = false;\r
+                $.handleError(opts, xhr, 'error', e);\r
+            }\r
+\r
+            // ordering of these callbacks/triggers is odd, but that's how $.ajax does it\r
+            if (ok) {\r
+                opts.success(data, 'success');\r
+                if (g) $.event.trigger("ajaxSuccess", [xhr, opts]);\r
+            }\r
+            if (g) $.event.trigger("ajaxComplete", [xhr, opts]);\r
+            if (g && ! --$.active) $.event.trigger("ajaxStop");\r
+            if (opts.complete) opts.complete(xhr, ok ? 'success' : 'error');\r
+\r
+            // clean up\r
+            setTimeout(function() {\r
+                $io.remove();\r
+                xhr.responseXML = null;\r
+            }, 100);\r
+        };\r
+\r
+        function toXml(s, doc) {\r
+            if (window.ActiveXObject) {\r
+                doc = new ActiveXObject('Microsoft.XMLDOM');\r
+                doc.async = 'false';\r
+                doc.loadXML(s);\r
+            }\r
+            else\r
+                doc = (new DOMParser()).parseFromString(s, 'text/xml');\r
+            return (doc && doc.documentElement && doc.documentElement.tagName != 'parsererror') ? doc : null;\r
+        };\r
+    };\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
+ * 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.\r
+ */ \r
+$.fn.ajaxForm = function(options) {\r
+    return this.ajaxFormUnbind().bind('submit.form-plugin',function() {\r
+        $(this).ajaxSubmit(options);\r
+        return false;\r
+    }).each(function() {\r
+        // store options in hash\r
+        $(":submit,input:image", this).bind('click.form-plugin',function(e) {\r
+            var form = this.form;\r
+            form.clk = this;\r
+            if (this.type == 'image') {\r
+                if (e.offsetX != undefined) {\r
+                    form.clk_x = e.offsetX;\r
+                    form.clk_y = e.offsetY;\r
+                } else if (typeof $.fn.offset == 'function') { // try to use dimensions plugin\r
+                    var offset = $(this).offset();\r
+                    form.clk_x = e.pageX - offset.left;\r
+                    form.clk_y = e.pageY - offset.top;\r
+                } else {\r
+                    form.clk_x = e.pageX - this.offsetLeft;\r
+                    form.clk_y = e.pageY - this.offsetTop;\r
+                }\r
+            }\r
+            // clear form vars\r
+            setTimeout(function() { form.clk = form.clk_x = form.clk_y = null; }, 10);\r
+        });\r
+    });\r
+};\r
+\r
+// ajaxFormUnbind unbinds the event handlers that were bound by ajaxForm\r
+$.fn.ajaxFormUnbind = function() {\r
+    this.unbind('submit.form-plugin');\r
+    return this.each(function() {\r
+        $(":submit,input:image", this).unbind('click.form-plugin');\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
+$.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
+\r
+        var v = $.fieldValue(el, true);\r
+        if (v && 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 if (v !== null && typeof v != 'undefined')\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
+ * Serializes form data into a 'submittable' string. This method will return a string\r
+ * in the format: name1=value1&amp;name2=value2\r
+ */\r
+$.fn.formSerialize = function(semantic) {\r
+    //hand off to jQuery.param for proper encoding\r
+    return $.param(this.formToArray(semantic));\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
+$.fn.fieldSerialize = function(successful) {\r
+    var a = [];\r
+    this.each(function() {\r
+        var n = this.name;\r
+        if (!n) return;\r
+        var v = $.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 $.param(a);\r
+};\r
+\r
+/**\r
+ * Returns the value(s) of the element in the matched set.  For example, consider the following form:\r
+ *\r
+ *  <form><fieldset>\r
+ *      <input name="A" type="text" />\r
+ *      <input name="A" type="text" />\r
+ *      <input name="B" type="checkbox" value="B1" />\r
+ *      <input name="B" type="checkbox" value="B2"/>\r
+ *      <input name="C" type="radio" value="C1" />\r
+ *      <input name="C" type="radio" value="C2" />\r
+ *  </fieldset></form>\r
+ *\r
+ *  var v = $(':text').fieldValue();\r
+ *  // if no values are entered into the text inputs\r
+ *  v == ['','']\r
+ *  // if values entered into the text inputs are 'foo' and 'bar'\r
+ *  v == ['foo','bar']\r
+ *\r
+ *  var v = $(':checkbox').fieldValue();\r
+ *  // if neither checkbox is checked\r
+ *  v === undefined\r
+ *  // if both checkboxes are checked\r
+ *  v == ['B1', 'B2']\r
+ *\r
+ *  var v = $(':radio').fieldValue();\r
+ *  // if neither radio is checked\r
+ *  v === undefined\r
+ *  // if first radio is checked\r
+ *  v == ['C1']\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 the value(s)\r
+ * for each element is returned.\r
+ *\r
+ * Note: This method *always* returns an array.  If no valid value can be determined the\r
+ *       array will be empty, otherwise it will contain one or more values.\r
+ */\r
+$.fn.fieldValue = function(successful) {\r
+    for (var val=[], i=0, max=this.length; i < max; i++) {\r
+        var el = this[i];\r
+        var v = $.fieldValue(el, successful);\r
+        if (v === null || typeof v == 'undefined' || (v.constructor == Array && !v.length))\r
+            continue;\r
+        v.constructor == Array ? $.merge(val, v) : val.push(v);\r
+    }\r
+    return val;\r
+};\r
+\r
+/**\r
+ * Returns the value of the field element.\r
+ */\r
+$.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' || t == 'button' ||\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 = $.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
+ * 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
+$.fn.clearForm = function() {\r
+    return this.each(function() {\r
+        $('input,select,textarea', this).clearFields();\r
+    });\r
+};\r
+\r
+/**\r
+ * Clears the selected form elements.\r
+ */\r
+$.fn.clearFields = $.fn.clearInputs = function() {\r
+    return this.each(function() {\r
+        var t = this.type, tag = this.tagName.toLowerCase();\r
+        if (t == 'file' || 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
+ * Resets the form data.  Causes all form elements to be reset to their original value.\r
+ */\r
+$.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
+\r
+/**\r
+ * Enables or disables any matching elements.\r
+ */\r
+$.fn.enable = function(b) { \r
+    if (b == undefined) b = true;\r
+    return this.each(function() { \r
+        this.disabled = !b \r
+    });\r
+};\r
+\r
+/**\r
+ * Checks/unchecks any matching checkboxes or radio buttons and\r
+ * selects/deselects and matching option elements.\r
+ */\r
+$.fn.selected = function(select) {\r
+    if (select == undefined) select = true;\r
+    return this.each(function() { \r
+        var t = this.type;\r
+        if (t == 'checkbox' || t == 'radio')\r
+            this.checked = select;\r
+        else if (this.tagName.toLowerCase() == 'option') {\r
+            var $sel = $(this).parent('select');\r
+            if (select && $sel[0] && $sel[0].type == 'select-one') {\r
+                // deselect all other options\r
+                $sel.find('option').selected(false);\r
+            }\r
+            this.selected = select;\r
+        }\r
+    });\r
+};\r
+\r
+// helper fn for console logging\r
+// set $.fn.ajaxSubmit.debug to true to enable debug logging\r
+function log() {\r
+    if ($.fn.ajaxSubmit.debug && window.console && window.console.log)\r
+        window.console.log('[jquery.form] ' + Array.prototype.join.call(arguments,''));\r
+};\r
+\r
+})(jQuery);\r