mp-wp_genesis 1 /*
mp-wp_genesis 2 * jQuery Form Plugin
mp-wp_genesis 3 * version: 2.02 (12/16/2007)
mp-wp_genesis 4 * @requires jQuery v1.1 or later
mp-wp_genesis 5 *
mp-wp_genesis 6 * Examples at: http://malsup.com/jquery/form/
mp-wp_genesis 7 * Dual licensed under the MIT and GPL licenses:
mp-wp_genesis 8 * http://www.opensource.org/licenses/mit-license.php
mp-wp_genesis 9 * http://www.gnu.org/licenses/gpl.html
mp-wp_genesis 10 *
mp-wp_genesis 11 * Revision: $Id$
mp-wp_genesis 12 */
mp-wp_genesis 13 (function($) {
mp-wp_genesis 14 /**
mp-wp_genesis 15 * ajaxSubmit() provides a mechanism for submitting an HTML form using AJAX.
mp-wp_genesis 16 *
mp-wp_genesis 17 * ajaxSubmit accepts a single argument which can be either a success callback function
mp-wp_genesis 18 * or an options Object. If a function is provided it will be invoked upon successful
mp-wp_genesis 19 * completion of the submit and will be passed the response from the server.
mp-wp_genesis 20 * If an options Object is provided, the following attributes are supported:
mp-wp_genesis 21 *
mp-wp_genesis 22 * target: Identifies the element(s) in the page to be updated with the server response.
mp-wp_genesis 23 * This value may be specified as a jQuery selection string, a jQuery object,
mp-wp_genesis 24 * or a DOM element.
mp-wp_genesis 25 * default value: null
mp-wp_genesis 26 *
mp-wp_genesis 27 * url: URL to which the form data will be submitted.
mp-wp_genesis 28 * default value: value of form's 'action' attribute
mp-wp_genesis 29 *
mp-wp_genesis 30 * type: The method in which the form data should be submitted, 'GET' or 'POST'.
mp-wp_genesis 31 * default value: value of form's 'method' attribute (or 'GET' if none found)
mp-wp_genesis 32 *
mp-wp_genesis 33 * data: Additional data to add to the request, specified as key/value pairs (see $.ajax).
mp-wp_genesis 34 *
mp-wp_genesis 35 * beforeSubmit: Callback method to be invoked before the form is submitted.
mp-wp_genesis 36 * default value: null
mp-wp_genesis 37 *
mp-wp_genesis 38 * success: Callback method to be invoked after the form has been successfully submitted
mp-wp_genesis 39 * and the response has been returned from the server
mp-wp_genesis 40 * default value: null
mp-wp_genesis 41 *
mp-wp_genesis 42 * dataType: Expected dataType of the response. One of: null, 'xml', 'script', or 'json'
mp-wp_genesis 43 * default value: null
mp-wp_genesis 44 *
mp-wp_genesis 45 * semantic: Boolean flag indicating whether data must be submitted in semantic order (slower).
mp-wp_genesis 46 * default value: false
mp-wp_genesis 47 *
mp-wp_genesis 48 * resetForm: Boolean flag indicating whether the form should be reset if the submit is successful
mp-wp_genesis 49 *
mp-wp_genesis 50 * clearForm: Boolean flag indicating whether the form should be cleared if the submit is successful
mp-wp_genesis 51 *
mp-wp_genesis 52 *
mp-wp_genesis 53 * The 'beforeSubmit' callback can be provided as a hook for running pre-submit logic or for
mp-wp_genesis 54 * validating the form data. If the 'beforeSubmit' callback returns false then the form will
mp-wp_genesis 55 * not be submitted. The 'beforeSubmit' callback is invoked with three arguments: the form data
mp-wp_genesis 56 * in array format, the jQuery object, and the options object passed into ajaxSubmit.
mp-wp_genesis 57 * The form data array takes the following form:
mp-wp_genesis 58 *
mp-wp_genesis 59 * [ { name: 'username', value: 'jresig' }, { name: 'password', value: 'secret' } ]
mp-wp_genesis 60 *
mp-wp_genesis 61 * If a 'success' callback method is provided it is invoked after the response has been returned
mp-wp_genesis 62 * from the server. It is passed the responseText or responseXML value (depending on dataType).
mp-wp_genesis 63 * See jQuery.ajax for further details.
mp-wp_genesis 64 *
mp-wp_genesis 65 *
mp-wp_genesis 66 * The dataType option provides a means for specifying how the server response should be handled.
mp-wp_genesis 67 * This maps directly to the jQuery.httpData method. The following values are supported:
mp-wp_genesis 68 *
mp-wp_genesis 69 * 'xml': if dataType == 'xml' the server response is treated as XML and the 'success'
mp-wp_genesis 70 * callback method, if specified, will be passed the responseXML value
mp-wp_genesis 71 * 'json': if dataType == 'json' the server response will be evaluted and passed to
mp-wp_genesis 72 * the 'success' callback, if specified
mp-wp_genesis 73 * 'script': if dataType == 'script' the server response is evaluated in the global context
mp-wp_genesis 74 *
mp-wp_genesis 75 *
mp-wp_genesis 76 * Note that it does not make sense to use both the 'target' and 'dataType' options. If both
mp-wp_genesis 77 * are provided the target will be ignored.
mp-wp_genesis 78 *
mp-wp_genesis 79 * The semantic argument can be used to force form serialization in semantic order.
mp-wp_genesis 80 * This is normally true anyway, unless the form contains input elements of type='image'.
mp-wp_genesis 81 * If your form must be submitted with name/value pairs in semantic order and your form
mp-wp_genesis 82 * contains an input of type='image" then pass true for this arg, otherwise pass false
mp-wp_genesis 83 * (or nothing) to avoid the overhead for this logic.
mp-wp_genesis 84 *
mp-wp_genesis 85 *
mp-wp_genesis 86 * When used on its own, ajaxSubmit() is typically bound to a form's submit event like this:
mp-wp_genesis 87 *
mp-wp_genesis 88 * $("#form-id").submit(function() {
mp-wp_genesis 89 * $(this).ajaxSubmit(options);
mp-wp_genesis 90 * return false; // cancel conventional submit
mp-wp_genesis 91 * });
mp-wp_genesis 92 *
mp-wp_genesis 93 * When using ajaxForm(), however, this is done for you.
mp-wp_genesis 94 *
mp-wp_genesis 95 * @example
mp-wp_genesis 96 * $('#myForm').ajaxSubmit(function(data) {
mp-wp_genesis 97 * alert('Form submit succeeded! Server returned: ' + data);
mp-wp_genesis 98 * });
mp-wp_genesis 99 * @desc Submit form and alert server response
mp-wp_genesis 100 *
mp-wp_genesis 101 *
mp-wp_genesis 102 * @example
mp-wp_genesis 103 * var options = {
mp-wp_genesis 104 * target: '#myTargetDiv'
mp-wp_genesis 105 * };
mp-wp_genesis 106 * $('#myForm').ajaxSubmit(options);
mp-wp_genesis 107 * @desc Submit form and update page element with server response
mp-wp_genesis 108 *
mp-wp_genesis 109 *
mp-wp_genesis 110 * @example
mp-wp_genesis 111 * var options = {
mp-wp_genesis 112 * success: function(responseText) {
mp-wp_genesis 113 * alert(responseText);
mp-wp_genesis 114 * }
mp-wp_genesis 115 * };
mp-wp_genesis 116 * $('#myForm').ajaxSubmit(options);
mp-wp_genesis 117 * @desc Submit form and alert the server response
mp-wp_genesis 118 *
mp-wp_genesis 119 *
mp-wp_genesis 120 * @example
mp-wp_genesis 121 * var options = {
mp-wp_genesis 122 * beforeSubmit: function(formArray, jqForm) {
mp-wp_genesis 123 * if (formArray.length == 0) {
mp-wp_genesis 124 * alert('Please enter data.');
mp-wp_genesis 125 * return false;
mp-wp_genesis 126 * }
mp-wp_genesis 127 * }
mp-wp_genesis 128 * };
mp-wp_genesis 129 * $('#myForm').ajaxSubmit(options);
mp-wp_genesis 130 * @desc Pre-submit validation which aborts the submit operation if form data is empty
mp-wp_genesis 131 *
mp-wp_genesis 132 *
mp-wp_genesis 133 * @example
mp-wp_genesis 134 * var options = {
mp-wp_genesis 135 * url: myJsonUrl.php,
mp-wp_genesis 136 * dataType: 'json',
mp-wp_genesis 137 * success: function(data) {
mp-wp_genesis 138 * // 'data' is an object representing the the evaluated json data
mp-wp_genesis 139 * }
mp-wp_genesis 140 * };
mp-wp_genesis 141 * $('#myForm').ajaxSubmit(options);
mp-wp_genesis 142 * @desc json data returned and evaluated
mp-wp_genesis 143 *
mp-wp_genesis 144 *
mp-wp_genesis 145 * @example
mp-wp_genesis 146 * var options = {
mp-wp_genesis 147 * url: myXmlUrl.php,
mp-wp_genesis 148 * dataType: 'xml',
mp-wp_genesis 149 * success: function(responseXML) {
mp-wp_genesis 150 * // responseXML is XML document object
mp-wp_genesis 151 * var data = $('myElement', responseXML).text();
mp-wp_genesis 152 * }
mp-wp_genesis 153 * };
mp-wp_genesis 154 * $('#myForm').ajaxSubmit(options);
mp-wp_genesis 155 * @desc XML data returned from server
mp-wp_genesis 156 *
mp-wp_genesis 157 *
mp-wp_genesis 158 * @example
mp-wp_genesis 159 * var options = {
mp-wp_genesis 160 * resetForm: true
mp-wp_genesis 161 * };
mp-wp_genesis 162 * $('#myForm').ajaxSubmit(options);
mp-wp_genesis 163 * @desc submit form and reset it if successful
mp-wp_genesis 164 *
mp-wp_genesis 165 * @example
mp-wp_genesis 166 * $('#myForm).submit(function() {
mp-wp_genesis 167 * $(this).ajaxSubmit();
mp-wp_genesis 168 * return false;
mp-wp_genesis 169 * });
mp-wp_genesis 170 * @desc Bind form's submit event to use ajaxSubmit
mp-wp_genesis 171 *
mp-wp_genesis 172 *
mp-wp_genesis 173 * @name ajaxSubmit
mp-wp_genesis 174 * @type jQuery
mp-wp_genesis 175 * @param options object literal containing options which control the form submission process
mp-wp_genesis 176 * @cat Plugins/Form
mp-wp_genesis 177 * @return jQuery
mp-wp_genesis 178 */
mp-wp_genesis 179 $.fn.ajaxSubmit = function(options) {
mp-wp_genesis 180 if (typeof options == 'function')
mp-wp_genesis 181 options = { success: options };
mp-wp_genesis 182
mp-wp_genesis 183 options = $.extend({
mp-wp_genesis 184 url: this.attr('action') || window.location.toString(),
mp-wp_genesis 185 type: this.attr('method') || 'GET'
mp-wp_genesis 186 }, options || {});
mp-wp_genesis 187
mp-wp_genesis 188 // hook for manipulating the form data before it is extracted;
mp-wp_remove-tiny... 189 // convenient for use with rich editors
mp-wp_genesis 190 var veto = {};
mp-wp_genesis 191 $.event.trigger('form.pre.serialize', [this, options, veto]);
mp-wp_genesis 192 if (veto.veto) return this;
mp-wp_genesis 193
mp-wp_genesis 194 var a = this.formToArray(options.semantic);
mp-wp_genesis 195 if (options.data) {
mp-wp_genesis 196 for (var n in options.data)
mp-wp_genesis 197 a.push( { name: n, value: options.data[n] } );
mp-wp_genesis 198 }
mp-wp_genesis 199
mp-wp_genesis 200 // give pre-submit callback an opportunity to abort the submit
mp-wp_genesis 201 if (options.beforeSubmit && options.beforeSubmit(a, this, options) === false) return this;
mp-wp_genesis 202
mp-wp_genesis 203 // fire vetoable 'validate' event
mp-wp_genesis 204 $.event.trigger('form.submit.validate', [a, this, options, veto]);
mp-wp_genesis 205 if (veto.veto) return this;
mp-wp_genesis 206
mp-wp_genesis 207 var q = $.param(a);//.replace(/%20/g,'+');
mp-wp_genesis 208
mp-wp_genesis 209 if (options.type.toUpperCase() == 'GET') {
mp-wp_genesis 210 options.url += (options.url.indexOf('?') >= 0 ? '&' : '?') + q;
mp-wp_genesis 211 options.data = null; // data is null for 'get'
mp-wp_genesis 212 }
mp-wp_genesis 213 else
mp-wp_genesis 214 options.data = q; // data is the query string for 'post'
mp-wp_genesis 215
mp-wp_genesis 216 var $form = this, callbacks = [];
mp-wp_genesis 217 if (options.resetForm) callbacks.push(function() { $form.resetForm(); });
mp-wp_genesis 218 if (options.clearForm) callbacks.push(function() { $form.clearForm(); });
mp-wp_genesis 219
mp-wp_genesis 220 // perform a load on the target only if dataType is not provided
mp-wp_genesis 221 if (!options.dataType && options.target) {
mp-wp_genesis 222 var oldSuccess = options.success || function(){};
mp-wp_genesis 223 callbacks.push(function(data) {
mp-wp_genesis 224 if (this.evalScripts)
mp-wp_genesis 225 $(options.target).attr("innerHTML", data).evalScripts().each(oldSuccess, arguments);
mp-wp_genesis 226 else // jQuery v1.1.4
mp-wp_genesis 227 $(options.target).html(data).each(oldSuccess, arguments);
mp-wp_genesis 228 });
mp-wp_genesis 229 }
mp-wp_genesis 230 else if (options.success)
mp-wp_genesis 231 callbacks.push(options.success);
mp-wp_genesis 232
mp-wp_genesis 233 options.success = function(data, status) {
mp-wp_genesis 234 for (var i=0, max=callbacks.length; i < max; i++)
mp-wp_genesis 235 callbacks[i](data, status, $form);
mp-wp_genesis 236 };
mp-wp_genesis 237
mp-wp_genesis 238 // are there files to upload?
mp-wp_genesis 239 var files = $('input:file', this).fieldValue();
mp-wp_genesis 240 var found = false;
mp-wp_genesis 241 for (var j=0; j < files.length; j++)
mp-wp_genesis 242 if (files[j])
mp-wp_genesis 243 found = true;
mp-wp_genesis 244
mp-wp_genesis 245 // options.iframe allows user to force iframe mode
mp-wp_genesis 246 if (options.iframe || found) {
mp-wp_genesis 247 // hack to fix Safari hang (thanks to Tim Molendijk for this)
mp-wp_genesis 248 // see: http://groups.google.com/group/jquery-dev/browse_thread/thread/36395b7ab510dd5d
mp-wp_genesis 249 if ($.browser.safari && options.closeKeepAlive)
mp-wp_genesis 250 $.get(options.closeKeepAlive, fileUpload);
mp-wp_genesis 251 else
mp-wp_genesis 252 fileUpload();
mp-wp_genesis 253 }
mp-wp_genesis 254 else
mp-wp_genesis 255 $.ajax(options);
mp-wp_genesis 256
mp-wp_genesis 257 // fire 'notify' event
mp-wp_genesis 258 $.event.trigger('form.submit.notify', [this, options]);
mp-wp_genesis 259 return this;
mp-wp_genesis 260
mp-wp_genesis 261
mp-wp_genesis 262 // private function for handling file uploads (hat tip to YAHOO!)
mp-wp_genesis 263 function fileUpload() {
mp-wp_genesis 264 var form = $form[0];
mp-wp_genesis 265 var opts = $.extend({}, $.ajaxSettings, options);
mp-wp_genesis 266
mp-wp_genesis 267 var id = 'jqFormIO' + $.fn.ajaxSubmit.counter++;
mp-wp_genesis 268 var $io = $('<iframe id="' + id + '" name="' + id + '" />');
mp-wp_genesis 269 var io = $io[0];
mp-wp_genesis 270 var op8 = $.browser.opera && window.opera.version() < 9;
mp-wp_genesis 271 if ($.browser.msie || op8) io.src = 'javascript:false;document.write("");';
mp-wp_genesis 272 $io.css({ position: 'absolute', top: '-1000px', left: '-1000px' });
mp-wp_genesis 273
mp-wp_genesis 274 var xhr = { // mock object
mp-wp_genesis 275 responseText: null,
mp-wp_genesis 276 responseXML: null,
mp-wp_genesis 277 status: 0,
mp-wp_genesis 278 statusText: 'n/a',
mp-wp_genesis 279 getAllResponseHeaders: function() {},
mp-wp_genesis 280 getResponseHeader: function() {},
mp-wp_genesis 281 setRequestHeader: function() {}
mp-wp_genesis 282 };
mp-wp_genesis 283
mp-wp_genesis 284 var g = opts.global;
mp-wp_genesis 285 // trigger ajax global events so that activity/block indicators work like normal
mp-wp_genesis 286 if (g && ! $.active++) $.event.trigger("ajaxStart");
mp-wp_genesis 287 if (g) $.event.trigger("ajaxSend", [xhr, opts]);
mp-wp_genesis 288
mp-wp_genesis 289 var cbInvoked = 0;
mp-wp_genesis 290 var timedOut = 0;
mp-wp_genesis 291
mp-wp_genesis 292 // take a breath so that pending repaints get some cpu time before the upload starts
mp-wp_genesis 293 setTimeout(function() {
mp-wp_genesis 294 // make sure form attrs are set
mp-wp_genesis 295 var encAttr = form.encoding ? 'encoding' : 'enctype';
mp-wp_genesis 296 var t = $form.attr('target');
mp-wp_genesis 297 $form.attr({
mp-wp_genesis 298 target: id,
mp-wp_genesis 299 method: 'POST',
mp-wp_genesis 300 action: opts.url
mp-wp_genesis 301 });
mp-wp_genesis 302 form[encAttr] = 'multipart/form-data';
mp-wp_genesis 303
mp-wp_genesis 304 // support timout
mp-wp_genesis 305 if (opts.timeout)
mp-wp_genesis 306 setTimeout(function() { timedOut = true; cb(); }, opts.timeout);
mp-wp_genesis 307
mp-wp_genesis 308 // add iframe to doc and submit the form
mp-wp_genesis 309 $io.appendTo('body');
mp-wp_genesis 310 io.attachEvent ? io.attachEvent('onload', cb) : io.addEventListener('load', cb, false);
mp-wp_genesis 311 form.submit();
mp-wp_genesis 312 $form.attr('target', t); // reset target
mp-wp_genesis 313 }, 10);
mp-wp_genesis 314
mp-wp_genesis 315 function cb() {
mp-wp_genesis 316 if (cbInvoked++) return;
mp-wp_genesis 317
mp-wp_genesis 318 io.detachEvent ? io.detachEvent('onload', cb) : io.removeEventListener('load', cb, false);
mp-wp_genesis 319
mp-wp_genesis 320 var ok = true;
mp-wp_genesis 321 try {
mp-wp_genesis 322 if (timedOut) throw 'timeout';
mp-wp_genesis 323 // extract the server response from the iframe
mp-wp_genesis 324 var data, doc;
mp-wp_genesis 325 doc = io.contentWindow ? io.contentWindow.document : io.contentDocument ? io.contentDocument : io.document;
mp-wp_genesis 326 xhr.responseText = doc.body ? doc.body.innerHTML : null;
mp-wp_genesis 327 xhr.responseXML = doc.XMLDocument ? doc.XMLDocument : doc;
mp-wp_genesis 328
mp-wp_genesis 329 if (opts.dataType == 'json' || opts.dataType == 'script') {
mp-wp_genesis 330 var ta = doc.getElementsByTagName('textarea')[0];
mp-wp_genesis 331 data = ta ? ta.value : xhr.responseText;
mp-wp_genesis 332 if (opts.dataType == 'json')
mp-wp_genesis 333 eval("data = " + data);
mp-wp_genesis 334 else
mp-wp_genesis 335 $.globalEval(data);
mp-wp_genesis 336 }
mp-wp_genesis 337 else if (opts.dataType == 'xml') {
mp-wp_genesis 338 data = xhr.responseXML;
mp-wp_genesis 339 if (!data && xhr.responseText != null)
mp-wp_genesis 340 data = toXml(xhr.responseText);
mp-wp_genesis 341 }
mp-wp_genesis 342 else {
mp-wp_genesis 343 data = xhr.responseText;
mp-wp_genesis 344 }
mp-wp_genesis 345 }
mp-wp_genesis 346 catch(e){
mp-wp_genesis 347 ok = false;
mp-wp_genesis 348 $.handleError(opts, xhr, 'error', e);
mp-wp_genesis 349 }
mp-wp_genesis 350
mp-wp_genesis 351 // ordering of these callbacks/triggers is odd, but that's how $.ajax does it
mp-wp_genesis 352 if (ok) {
mp-wp_genesis 353 opts.success(data, 'success');
mp-wp_genesis 354 if (g) $.event.trigger("ajaxSuccess", [xhr, opts]);
mp-wp_genesis 355 }
mp-wp_genesis 356 if (g) $.event.trigger("ajaxComplete", [xhr, opts]);
mp-wp_genesis 357 if (g && ! --$.active) $.event.trigger("ajaxStop");
mp-wp_genesis 358 if (opts.complete) opts.complete(xhr, ok ? 'success' : 'error');
mp-wp_genesis 359
mp-wp_genesis 360 // clean up
mp-wp_genesis 361 setTimeout(function() {
mp-wp_genesis 362 $io.remove();
mp-wp_genesis 363 xhr.responseXML = null;
mp-wp_genesis 364 }, 100);
mp-wp_genesis 365 };
mp-wp_genesis 366
mp-wp_genesis 367 function toXml(s, doc) {
mp-wp_genesis 368 if (window.ActiveXObject) {
mp-wp_genesis 369 doc = new ActiveXObject('Microsoft.XMLDOM');
mp-wp_genesis 370 doc.async = 'false';
mp-wp_genesis 371 doc.loadXML(s);
mp-wp_genesis 372 }
mp-wp_genesis 373 else
mp-wp_genesis 374 doc = (new DOMParser()).parseFromString(s, 'text/xml');
mp-wp_genesis 375 return (doc && doc.documentElement && doc.documentElement.tagName != 'parsererror') ? doc : null;
mp-wp_genesis 376 };
mp-wp_genesis 377 };
mp-wp_genesis 378 };
mp-wp_genesis 379 $.fn.ajaxSubmit.counter = 0; // used to create unique iframe ids
mp-wp_genesis 380
mp-wp_genesis 381 /**
mp-wp_genesis 382 * ajaxForm() provides a mechanism for fully automating form submission.
mp-wp_genesis 383 *
mp-wp_genesis 384 * The advantages of using this method instead of ajaxSubmit() are:
mp-wp_genesis 385 *
mp-wp_genesis 386 * 1: This method will include coordinates for <input type="image" /> elements (if the element
mp-wp_genesis 387 * is used to submit the form).
mp-wp_genesis 388 * 2. This method will include the submit element's name/value data (for the element that was
mp-wp_genesis 389 * used to submit the form).
mp-wp_genesis 390 * 3. This method binds the submit() method to the form for you.
mp-wp_genesis 391 *
mp-wp_genesis 392 * Note that for accurate x/y coordinates of image submit elements in all browsers
mp-wp_genesis 393 * you need to also use the "dimensions" plugin (this method will auto-detect its presence).
mp-wp_genesis 394 *
mp-wp_genesis 395 * The options argument for ajaxForm works exactly as it does for ajaxSubmit. ajaxForm merely
mp-wp_genesis 396 * passes the options argument along after properly binding events for submit elements and
mp-wp_genesis 397 * the form itself. See ajaxSubmit for a full description of the options argument.
mp-wp_genesis 398 *
mp-wp_genesis 399 *
mp-wp_genesis 400 * @example
mp-wp_genesis 401 * var options = {
mp-wp_genesis 402 * target: '#myTargetDiv'
mp-wp_genesis 403 * };
mp-wp_genesis 404 * $('#myForm').ajaxSForm(options);
mp-wp_genesis 405 * @desc Bind form's submit event so that 'myTargetDiv' is updated with the server response
mp-wp_genesis 406 * when the form is submitted.
mp-wp_genesis 407 *
mp-wp_genesis 408 *
mp-wp_genesis 409 * @example
mp-wp_genesis 410 * var options = {
mp-wp_genesis 411 * success: function(responseText) {
mp-wp_genesis 412 * alert(responseText);
mp-wp_genesis 413 * }
mp-wp_genesis 414 * };
mp-wp_genesis 415 * $('#myForm').ajaxSubmit(options);
mp-wp_genesis 416 * @desc Bind form's submit event so that server response is alerted after the form is submitted.
mp-wp_genesis 417 *
mp-wp_genesis 418 *
mp-wp_genesis 419 * @example
mp-wp_genesis 420 * var options = {
mp-wp_genesis 421 * beforeSubmit: function(formArray, jqForm) {
mp-wp_genesis 422 * if (formArray.length == 0) {
mp-wp_genesis 423 * alert('Please enter data.');
mp-wp_genesis 424 * return false;
mp-wp_genesis 425 * }
mp-wp_genesis 426 * }
mp-wp_genesis 427 * };
mp-wp_genesis 428 * $('#myForm').ajaxSubmit(options);
mp-wp_genesis 429 * @desc Bind form's submit event so that pre-submit callback is invoked before the form
mp-wp_genesis 430 * is submitted.
mp-wp_genesis 431 *
mp-wp_genesis 432 *
mp-wp_genesis 433 * @name ajaxForm
mp-wp_genesis 434 * @param options object literal containing options which control the form submission process
mp-wp_genesis 435 * @return jQuery
mp-wp_genesis 436 * @cat Plugins/Form
mp-wp_genesis 437 * @type jQuery
mp-wp_genesis 438 */
mp-wp_genesis 439 $.fn.ajaxForm = function(options) {
mp-wp_genesis 440 return this.ajaxFormUnbind().submit(submitHandler).each(function() {
mp-wp_genesis 441 // store options in hash
mp-wp_genesis 442 this.formPluginId = $.fn.ajaxForm.counter++;
mp-wp_genesis 443 $.fn.ajaxForm.optionHash[this.formPluginId] = options;
mp-wp_genesis 444 $(":submit,input:image", this).click(clickHandler);
mp-wp_genesis 445 });
mp-wp_genesis 446 };
mp-wp_genesis 447
mp-wp_genesis 448 $.fn.ajaxForm.counter = 1;
mp-wp_genesis 449 $.fn.ajaxForm.optionHash = {};
mp-wp_genesis 450
mp-wp_genesis 451 function clickHandler(e) {
mp-wp_genesis 452 var $form = this.form;
mp-wp_genesis 453 $form.clk = this;
mp-wp_genesis 454 if (this.type == 'image') {
mp-wp_genesis 455 if (e.offsetX != undefined) {
mp-wp_genesis 456 $form.clk_x = e.offsetX;
mp-wp_genesis 457 $form.clk_y = e.offsetY;
mp-wp_genesis 458 } else if (typeof $.fn.offset == 'function') { // try to use dimensions plugin
mp-wp_genesis 459 var offset = $(this).offset();
mp-wp_genesis 460 $form.clk_x = e.pageX - offset.left;
mp-wp_genesis 461 $form.clk_y = e.pageY - offset.top;
mp-wp_genesis 462 } else {
mp-wp_genesis 463 $form.clk_x = e.pageX - this.offsetLeft;
mp-wp_genesis 464 $form.clk_y = e.pageY - this.offsetTop;
mp-wp_genesis 465 }
mp-wp_genesis 466 }
mp-wp_genesis 467 // clear form vars
mp-wp_genesis 468 setTimeout(function() { $form.clk = $form.clk_x = $form.clk_y = null; }, 10);
mp-wp_genesis 469 };
mp-wp_genesis 470
mp-wp_genesis 471 function submitHandler() {
mp-wp_genesis 472 // retrieve options from hash
mp-wp_genesis 473 var id = this.formPluginId;
mp-wp_genesis 474 var options = $.fn.ajaxForm.optionHash[id];
mp-wp_genesis 475 $(this).ajaxSubmit(options);
mp-wp_genesis 476 return false;
mp-wp_genesis 477 };
mp-wp_genesis 478
mp-wp_genesis 479 /**
mp-wp_genesis 480 * ajaxFormUnbind unbinds the event handlers that were bound by ajaxForm
mp-wp_genesis 481 *
mp-wp_genesis 482 * @name ajaxFormUnbind
mp-wp_genesis 483 * @return jQuery
mp-wp_genesis 484 * @cat Plugins/Form
mp-wp_genesis 485 * @type jQuery
mp-wp_genesis 486 */
mp-wp_genesis 487 $.fn.ajaxFormUnbind = function() {
mp-wp_genesis 488 this.unbind('submit', submitHandler);
mp-wp_genesis 489 return this.each(function() {
mp-wp_genesis 490 $(":submit,input:image", this).unbind('click', clickHandler);
mp-wp_genesis 491 });
mp-wp_genesis 492
mp-wp_genesis 493 };
mp-wp_genesis 494
mp-wp_genesis 495 /**
mp-wp_genesis 496 * formToArray() gathers form element data into an array of objects that can
mp-wp_genesis 497 * be passed to any of the following ajax functions: $.get, $.post, or load.
mp-wp_genesis 498 * Each object in the array has both a 'name' and 'value' property. An example of
mp-wp_genesis 499 * an array for a simple login form might be:
mp-wp_genesis 500 *
mp-wp_genesis 501 * [ { name: 'username', value: 'jresig' }, { name: 'password', value: 'secret' } ]
mp-wp_genesis 502 *
mp-wp_genesis 503 * It is this array that is passed to pre-submit callback functions provided to the
mp-wp_genesis 504 * ajaxSubmit() and ajaxForm() methods.
mp-wp_genesis 505 *
mp-wp_genesis 506 * The semantic argument can be used to force form serialization in semantic order.
mp-wp_genesis 507 * This is normally true anyway, unless the form contains input elements of type='image'.
mp-wp_genesis 508 * If your form must be submitted with name/value pairs in semantic order and your form
mp-wp_genesis 509 * contains an input of type='image" then pass true for this arg, otherwise pass false
mp-wp_genesis 510 * (or nothing) to avoid the overhead for this logic.
mp-wp_genesis 511 *
mp-wp_genesis 512 * @example var data = $("#myForm").formToArray();
mp-wp_genesis 513 * $.post( "myscript.cgi", data );
mp-wp_genesis 514 * @desc Collect all the data from a form and submit it to the server.
mp-wp_genesis 515 *
mp-wp_genesis 516 * @name formToArray
mp-wp_genesis 517 * @param semantic true if serialization must maintain strict semantic ordering of elements (slower)
mp-wp_genesis 518 * @type Array<Object>
mp-wp_genesis 519 * @cat Plugins/Form
mp-wp_genesis 520 */
mp-wp_genesis 521 $.fn.formToArray = function(semantic) {
mp-wp_genesis 522 var a = [];
mp-wp_genesis 523 if (this.length == 0) return a;
mp-wp_genesis 524
mp-wp_genesis 525 var form = this[0];
mp-wp_genesis 526 var els = semantic ? form.getElementsByTagName('*') : form.elements;
mp-wp_genesis 527 if (!els) return a;
mp-wp_genesis 528 for(var i=0, max=els.length; i < max; i++) {
mp-wp_genesis 529 var el = els[i];
mp-wp_genesis 530 var n = el.name;
mp-wp_genesis 531 if (!n) continue;
mp-wp_genesis 532
mp-wp_genesis 533 if (semantic && form.clk && el.type == "image") {
mp-wp_genesis 534 // handle image inputs on the fly when semantic == true
mp-wp_genesis 535 if(!el.disabled && form.clk == el)
mp-wp_genesis 536 a.push({name: n+'.x', value: form.clk_x}, {name: n+'.y', value: form.clk_y});
mp-wp_genesis 537 continue;
mp-wp_genesis 538 }
mp-wp_genesis 539
mp-wp_genesis 540 var v = $.fieldValue(el, true);
mp-wp_genesis 541 if (v && v.constructor == Array) {
mp-wp_genesis 542 for(var j=0, jmax=v.length; j < jmax; j++)
mp-wp_genesis 543 a.push({name: n, value: v[j]});
mp-wp_genesis 544 }
mp-wp_genesis 545 else if (v !== null && typeof v != 'undefined')
mp-wp_genesis 546 a.push({name: n, value: v});
mp-wp_genesis 547 }
mp-wp_genesis 548
mp-wp_genesis 549 if (!semantic && form.clk) {
mp-wp_genesis 550 // input type=='image' are not found in elements array! handle them here
mp-wp_genesis 551 var inputs = form.getElementsByTagName("input");
mp-wp_genesis 552 for(var i=0, max=inputs.length; i < max; i++) {
mp-wp_genesis 553 var input = inputs[i];
mp-wp_genesis 554 var n = input.name;
mp-wp_genesis 555 if(n && !input.disabled && input.type == "image" && form.clk == input)
mp-wp_genesis 556 a.push({name: n+'.x', value: form.clk_x}, {name: n+'.y', value: form.clk_y});
mp-wp_genesis 557 }
mp-wp_genesis 558 }
mp-wp_genesis 559 return a;
mp-wp_genesis 560 };
mp-wp_genesis 561
mp-wp_genesis 562
mp-wp_genesis 563 /**
mp-wp_genesis 564 * Serializes form data into a 'submittable' string. This method will return a string
mp-wp_genesis 565 * in the format: name1=value1&name2=value2
mp-wp_genesis 566 *
mp-wp_genesis 567 * The semantic argument can be used to force form serialization in semantic order.
mp-wp_genesis 568 * If your form must be submitted with name/value pairs in semantic order then pass
mp-wp_genesis 569 * true for this arg, otherwise pass false (or nothing) to avoid the overhead for
mp-wp_genesis 570 * this logic (which can be significant for very large forms).
mp-wp_genesis 571 *
mp-wp_genesis 572 * @example var data = $("#myForm").formSerialize();
mp-wp_genesis 573 * $.ajax('POST', "myscript.cgi", data);
mp-wp_genesis 574 * @desc Collect all the data from a form into a single string
mp-wp_genesis 575 *
mp-wp_genesis 576 * @name formSerialize
mp-wp_genesis 577 * @param semantic true if serialization must maintain strict semantic ordering of elements (slower)
mp-wp_genesis 578 * @type String
mp-wp_genesis 579 * @cat Plugins/Form
mp-wp_genesis 580 */
mp-wp_genesis 581 $.fn.formSerialize = function(semantic) {
mp-wp_genesis 582 //hand off to jQuery.param for proper encoding
mp-wp_genesis 583 return $.param(this.formToArray(semantic));
mp-wp_genesis 584 };
mp-wp_genesis 585
mp-wp_genesis 586
mp-wp_genesis 587 /**
mp-wp_genesis 588 * Serializes all field elements in the jQuery object into a query string.
mp-wp_genesis 589 * This method will return a string in the format: name1=value1&name2=value2
mp-wp_genesis 590 *
mp-wp_genesis 591 * The successful argument controls whether or not serialization is limited to
mp-wp_genesis 592 * 'successful' controls (per http://www.w3.org/TR/html4/interact/forms.html#successful-controls).
mp-wp_genesis 593 * The default value of the successful argument is true.
mp-wp_genesis 594 *
mp-wp_genesis 595 * @example var data = $("input").formSerialize();
mp-wp_genesis 596 * @desc Collect the data from all successful input elements into a query string
mp-wp_genesis 597 *
mp-wp_genesis 598 * @example var data = $(":radio").formSerialize();
mp-wp_genesis 599 * @desc Collect the data from all successful radio input elements into a query string
mp-wp_genesis 600 *
mp-wp_genesis 601 * @example var data = $("#myForm :checkbox").formSerialize();
mp-wp_genesis 602 * @desc Collect the data from all successful checkbox input elements in myForm into a query string
mp-wp_genesis 603 *
mp-wp_genesis 604 * @example var data = $("#myForm :checkbox").formSerialize(false);
mp-wp_genesis 605 * @desc Collect the data from all checkbox elements in myForm (even the unchecked ones) into a query string
mp-wp_genesis 606 *
mp-wp_genesis 607 * @example var data = $(":input").formSerialize();
mp-wp_genesis 608 * @desc Collect the data from all successful input, select, textarea and button elements into a query string
mp-wp_genesis 609 *
mp-wp_genesis 610 * @name fieldSerialize
mp-wp_genesis 611 * @param successful true if only successful controls should be serialized (default is true)
mp-wp_genesis 612 * @type String
mp-wp_genesis 613 * @cat Plugins/Form
mp-wp_genesis 614 */
mp-wp_genesis 615 $.fn.fieldSerialize = function(successful) {
mp-wp_genesis 616 var a = [];
mp-wp_genesis 617 this.each(function() {
mp-wp_genesis 618 var n = this.name;
mp-wp_genesis 619 if (!n) return;
mp-wp_genesis 620 var v = $.fieldValue(this, successful);
mp-wp_genesis 621 if (v && v.constructor == Array) {
mp-wp_genesis 622 for (var i=0,max=v.length; i < max; i++)
mp-wp_genesis 623 a.push({name: n, value: v[i]});
mp-wp_genesis 624 }
mp-wp_genesis 625 else if (v !== null && typeof v != 'undefined')
mp-wp_genesis 626 a.push({name: this.name, value: v});
mp-wp_genesis 627 });
mp-wp_genesis 628 //hand off to jQuery.param for proper encoding
mp-wp_genesis 629 return $.param(a);
mp-wp_genesis 630 };
mp-wp_genesis 631
mp-wp_genesis 632
mp-wp_genesis 633 /**
mp-wp_genesis 634 * Returns the value(s) of the element in the matched set. For example, consider the following form:
mp-wp_genesis 635 *
mp-wp_genesis 636 * <form><fieldset>
mp-wp_genesis 637 * <input name="A" type="text" />
mp-wp_genesis 638 * <input name="A" type="text" />
mp-wp_genesis 639 * <input name="B" type="checkbox" value="B1" />
mp-wp_genesis 640 * <input name="B" type="checkbox" value="B2"/>
mp-wp_genesis 641 * <input name="C" type="radio" value="C1" />
mp-wp_genesis 642 * <input name="C" type="radio" value="C2" />
mp-wp_genesis 643 * </fieldset></form>
mp-wp_genesis 644 *
mp-wp_genesis 645 * var v = $(':text').fieldValue();
mp-wp_genesis 646 * // if no values are entered into the text inputs
mp-wp_genesis 647 * v == ['','']
mp-wp_genesis 648 * // if values entered into the text inputs are 'foo' and 'bar'
mp-wp_genesis 649 * v == ['foo','bar']
mp-wp_genesis 650 *
mp-wp_genesis 651 * var v = $(':checkbox').fieldValue();
mp-wp_genesis 652 * // if neither checkbox is checked
mp-wp_genesis 653 * v === undefined
mp-wp_genesis 654 * // if both checkboxes are checked
mp-wp_genesis 655 * v == ['B1', 'B2']
mp-wp_genesis 656 *
mp-wp_genesis 657 * var v = $(':radio').fieldValue();
mp-wp_genesis 658 * // if neither radio is checked
mp-wp_genesis 659 * v === undefined
mp-wp_genesis 660 * // if first radio is checked
mp-wp_genesis 661 * v == ['C1']
mp-wp_genesis 662 *
mp-wp_genesis 663 * The successful argument controls whether or not the field element must be 'successful'
mp-wp_genesis 664 * (per http://www.w3.org/TR/html4/interact/forms.html#successful-controls).
mp-wp_genesis 665 * The default value of the successful argument is true. If this value is false the value(s)
mp-wp_genesis 666 * for each element is returned.
mp-wp_genesis 667 *
mp-wp_genesis 668 * Note: This method *always* returns an array. If no valid value can be determined the
mp-wp_genesis 669 * array will be empty, otherwise it will contain one or more values.
mp-wp_genesis 670 *
mp-wp_genesis 671 * @example var data = $("#myPasswordElement").fieldValue();
mp-wp_genesis 672 * alert(data[0]);
mp-wp_genesis 673 * @desc Alerts the current value of the myPasswordElement element
mp-wp_genesis 674 *
mp-wp_genesis 675 * @example var data = $("#myForm :input").fieldValue();
mp-wp_genesis 676 * @desc Get the value(s) of the form elements in myForm
mp-wp_genesis 677 *
mp-wp_genesis 678 * @example var data = $("#myForm :checkbox").fieldValue();
mp-wp_genesis 679 * @desc Get the value(s) for the successful checkbox element(s) in the jQuery object.
mp-wp_genesis 680 *
mp-wp_genesis 681 * @example var data = $("#mySingleSelect").fieldValue();
mp-wp_genesis 682 * @desc Get the value(s) of the select control
mp-wp_genesis 683 *
mp-wp_genesis 684 * @example var data = $(':text').fieldValue();
mp-wp_genesis 685 * @desc Get the value(s) of the text input or textarea elements
mp-wp_genesis 686 *
mp-wp_genesis 687 * @example var data = $("#myMultiSelect").fieldValue();
mp-wp_genesis 688 * @desc Get the values for the select-multiple control
mp-wp_genesis 689 *
mp-wp_genesis 690 * @name fieldValue
mp-wp_genesis 691 * @param Boolean successful true if only the values for successful controls should be returned (default is true)
mp-wp_genesis 692 * @type Array<String>
mp-wp_genesis 693 * @cat Plugins/Form
mp-wp_genesis 694 */
mp-wp_genesis 695 $.fn.fieldValue = function(successful) {
mp-wp_genesis 696 for (var val=[], i=0, max=this.length; i < max; i++) {
mp-wp_genesis 697 var el = this[i];
mp-wp_genesis 698 var v = $.fieldValue(el, successful);
mp-wp_genesis 699 if (v === null || typeof v == 'undefined' || (v.constructor == Array && !v.length))
mp-wp_genesis 700 continue;
mp-wp_genesis 701 v.constructor == Array ? $.merge(val, v) : val.push(v);
mp-wp_genesis 702 }
mp-wp_genesis 703 return val;
mp-wp_genesis 704 };
mp-wp_genesis 705
mp-wp_genesis 706 /**
mp-wp_genesis 707 * Returns the value of the field element.
mp-wp_genesis 708 *
mp-wp_genesis 709 * The successful argument controls whether or not the field element must be 'successful'
mp-wp_genesis 710 * (per http://www.w3.org/TR/html4/interact/forms.html#successful-controls).
mp-wp_genesis 711 * The default value of the successful argument is true. If the given element is not
mp-wp_genesis 712 * successful and the successful arg is not false then the returned value will be null.
mp-wp_genesis 713 *
mp-wp_genesis 714 * Note: If the successful flag is true (default) but the element is not successful, the return will be null
mp-wp_genesis 715 * Note: The value returned for a successful select-multiple element will always be an array.
mp-wp_genesis 716 * Note: If the element has no value the return value will be undefined.
mp-wp_genesis 717 *
mp-wp_genesis 718 * @example var data = jQuery.fieldValue($("#myPasswordElement")[0]);
mp-wp_genesis 719 * @desc Gets the current value of the myPasswordElement element
mp-wp_genesis 720 *
mp-wp_genesis 721 * @name fieldValue
mp-wp_genesis 722 * @param Element el The DOM element for which the value will be returned
mp-wp_genesis 723 * @param Boolean successful true if value returned must be for a successful controls (default is true)
mp-wp_genesis 724 * @type String or Array<String> or null or undefined
mp-wp_genesis 725 * @cat Plugins/Form
mp-wp_genesis 726 */
mp-wp_genesis 727 $.fieldValue = function(el, successful) {
mp-wp_genesis 728 var n = el.name, t = el.type, tag = el.tagName.toLowerCase();
mp-wp_genesis 729 if (typeof successful == 'undefined') successful = true;
mp-wp_genesis 730
mp-wp_genesis 731 if (successful && (!n || el.disabled || t == 'reset' || t == 'button' ||
mp-wp_genesis 732 (t == 'checkbox' || t == 'radio') && !el.checked ||
mp-wp_genesis 733 (t == 'submit' || t == 'image') && el.form && el.form.clk != el ||
mp-wp_genesis 734 tag == 'select' && el.selectedIndex == -1))
mp-wp_genesis 735 return null;
mp-wp_genesis 736
mp-wp_genesis 737 if (tag == 'select') {
mp-wp_genesis 738 var index = el.selectedIndex;
mp-wp_genesis 739 if (index < 0) return null;
mp-wp_genesis 740 var a = [], ops = el.options;
mp-wp_genesis 741 var one = (t == 'select-one');
mp-wp_genesis 742 var max = (one ? index+1 : ops.length);
mp-wp_genesis 743 for(var i=(one ? index : 0); i < max; i++) {
mp-wp_genesis 744 var op = ops[i];
mp-wp_genesis 745 if (op.selected) {
mp-wp_genesis 746 // extra pain for IE...
mp-wp_genesis 747 var v = $.browser.msie && !(op.attributes['value'].specified) ? op.text : op.value;
mp-wp_genesis 748 if (one) return v;
mp-wp_genesis 749 a.push(v);
mp-wp_genesis 750 }
mp-wp_genesis 751 }
mp-wp_genesis 752 return a;
mp-wp_genesis 753 }
mp-wp_genesis 754 return el.value;
mp-wp_genesis 755 };
mp-wp_genesis 756
mp-wp_genesis 757
mp-wp_genesis 758 /**
mp-wp_genesis 759 * Clears the form data. Takes the following actions on the form's input fields:
mp-wp_genesis 760 * - input text fields will have their 'value' property set to the empty string
mp-wp_genesis 761 * - select elements will have their 'selectedIndex' property set to -1
mp-wp_genesis 762 * - checkbox and radio inputs will have their 'checked' property set to false
mp-wp_genesis 763 * - inputs of type submit, button, reset, and hidden will *not* be effected
mp-wp_genesis 764 * - button elements will *not* be effected
mp-wp_genesis 765 *
mp-wp_genesis 766 * @example $('form').clearForm();
mp-wp_genesis 767 * @desc Clears all forms on the page.
mp-wp_genesis 768 *
mp-wp_genesis 769 * @name clearForm
mp-wp_genesis 770 * @type jQuery
mp-wp_genesis 771 * @cat Plugins/Form
mp-wp_genesis 772 */
mp-wp_genesis 773 $.fn.clearForm = function() {
mp-wp_genesis 774 return this.each(function() {
mp-wp_genesis 775 $('input,select,textarea', this).clearFields();
mp-wp_genesis 776 });
mp-wp_genesis 777 };
mp-wp_genesis 778
mp-wp_genesis 779 /**
mp-wp_genesis 780 * Clears the selected form elements. Takes the following actions on the matched elements:
mp-wp_genesis 781 * - input text fields will have their 'value' property set to the empty string
mp-wp_genesis 782 * - select elements will have their 'selectedIndex' property set to -1
mp-wp_genesis 783 * - checkbox and radio inputs will have their 'checked' property set to false
mp-wp_genesis 784 * - inputs of type submit, button, reset, and hidden will *not* be effected
mp-wp_genesis 785 * - button elements will *not* be effected
mp-wp_genesis 786 *
mp-wp_genesis 787 * @example $('.myInputs').clearFields();
mp-wp_genesis 788 * @desc Clears all inputs with class myInputs
mp-wp_genesis 789 *
mp-wp_genesis 790 * @name clearFields
mp-wp_genesis 791 * @type jQuery
mp-wp_genesis 792 * @cat Plugins/Form
mp-wp_genesis 793 */
mp-wp_genesis 794 $.fn.clearFields = $.fn.clearInputs = function() {
mp-wp_genesis 795 return this.each(function() {
mp-wp_genesis 796 var t = this.type, tag = this.tagName.toLowerCase();
mp-wp_genesis 797 if (t == 'text' || t == 'password' || tag == 'textarea')
mp-wp_genesis 798 this.value = '';
mp-wp_genesis 799 else if (t == 'checkbox' || t == 'radio')
mp-wp_genesis 800 this.checked = false;
mp-wp_genesis 801 else if (tag == 'select')
mp-wp_genesis 802 this.selectedIndex = -1;
mp-wp_genesis 803 });
mp-wp_genesis 804 };
mp-wp_genesis 805
mp-wp_genesis 806
mp-wp_genesis 807 /**
mp-wp_genesis 808 * Resets the form data. Causes all form elements to be reset to their original value.
mp-wp_genesis 809 *
mp-wp_genesis 810 * @example $('form').resetForm();
mp-wp_genesis 811 * @desc Resets all forms on the page.
mp-wp_genesis 812 *
mp-wp_genesis 813 * @name resetForm
mp-wp_genesis 814 * @type jQuery
mp-wp_genesis 815 * @cat Plugins/Form
mp-wp_genesis 816 */
mp-wp_genesis 817 $.fn.resetForm = function() {
mp-wp_genesis 818 return this.each(function() {
mp-wp_genesis 819 // guard against an input with the name of 'reset'
mp-wp_genesis 820 // note that IE reports the reset function as an 'object'
mp-wp_genesis 821 if (typeof this.reset == 'function' || (typeof this.reset == 'object' && !this.reset.nodeType))
mp-wp_genesis 822 this.reset();
mp-wp_genesis 823 });
mp-wp_genesis 824 };
mp-wp_genesis 825
mp-wp_genesis 826
mp-wp_genesis 827 /**
mp-wp_genesis 828 * Enables or disables any matching elements.
mp-wp_genesis 829 *
mp-wp_genesis 830 * @example $(':radio').enabled(false);
mp-wp_genesis 831 * @desc Disables all radio buttons
mp-wp_genesis 832 *
mp-wp_genesis 833 * @name select
mp-wp_genesis 834 * @type jQuery
mp-wp_genesis 835 * @cat Plugins/Form
mp-wp_genesis 836 */
mp-wp_genesis 837 $.fn.enable = function(b) {
mp-wp_genesis 838 if (b == undefined) b = true;
mp-wp_genesis 839 return this.each(function() {
mp-wp_genesis 840 this.disabled = !b
mp-wp_genesis 841 });
mp-wp_genesis 842 };
mp-wp_genesis 843
mp-wp_genesis 844 /**
mp-wp_genesis 845 * Checks/unchecks any matching checkboxes or radio buttons and
mp-wp_genesis 846 * selects/deselects and matching option elements.
mp-wp_genesis 847 *
mp-wp_genesis 848 * @example $(':checkbox').selected();
mp-wp_genesis 849 * @desc Checks all checkboxes
mp-wp_genesis 850 *
mp-wp_genesis 851 * @name select
mp-wp_genesis 852 * @type jQuery
mp-wp_genesis 853 * @cat Plugins/Form
mp-wp_genesis 854 */
mp-wp_genesis 855 $.fn.select = function(select) {
mp-wp_genesis 856 if (select == undefined) select = true;
mp-wp_genesis 857 return this.each(function() {
mp-wp_genesis 858 var t = this.type;
mp-wp_genesis 859 if (t == 'checkbox' || t == 'radio')
mp-wp_genesis 860 this.checked = select;
mp-wp_genesis 861 else if (this.tagName.toLowerCase() == 'option') {
mp-wp_genesis 862 var $sel = $(this).parent('select');
mp-wp_genesis 863 if (select && $sel[0] && $sel[0].type == 'select-one') {
mp-wp_genesis 864 // deselect all other options
mp-wp_genesis 865 $sel.find('option').select(false);
mp-wp_genesis 866 }
mp-wp_genesis 867 this.selected = select;
mp-wp_genesis 868 }
mp-wp_genesis 869 });
mp-wp_genesis 870 };
mp-wp_genesis 871
mp-wp_genesis 872 })(jQuery);