click/framework/src/META-INF/resources/click/control.js - click - Git at Google

 // Licensed to the Apache Software Foundation (ASF) under one
 // or more contributor license agreements.  See the NOTICE file
 // distributed with this work for additional information
 // regarding copyright ownership.  The ASF licenses this file
 // to you under the Apache License, Version 2.0 (the
 // "License"); you may not use this file except in compliance
 // with the License.  You may obtain a copy of the License at
 //
 //   http://www.apache.org/licenses/LICENSE-2.0
 //
 // Unless required by applicable law or agreed to in writing,
 // software distributed under the License is distributed on an
 // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 // KIND, either express or implied.  See the License for the
 // specific language governing permissions and limitations
 // under the License.

 // Ensure Click namespace exists
 if ( typeof Click == 'undefined' )
     Click = {};

 /**
  * DomReady state variables.
  */
 if ( typeof Click.domready == 'undefined' ) {
     Click.domready = {
         events: [],
         ready: false,
         run : function() {
             if ( !document.body ) {
               // If body is null run this function after timeout
               return setTimeout(arguments.callee, 13);
             }
             Click.domready.ready=true;
             var e;
             while(e = Click.domready.events.shift()) {
                 e();
             }
         }
     }
 }

 /**
  * This function is based on work done by Dean Edwards, Diego Perini,
  * Matthias Miller, John Resig and Jesse Skinner.
  *
  * http://dean.edwards.name/weblog/2006/06/again/
  * http://simonwillison.net/2004/May/26/addLoadEvent/
  * http://javascript.nwbox.com/IEContentLoaded/
  * http://www.thefutureoftheweb.com/blog/adddomloadevent/
  * http://www.subprint.com/blog/demystifying-the-dom-ready-event-method/
  */
 (function() {
     // Handle DOMContentLoaded compliant browsers.
     if (document.addEventListener) {
       document.addEventListener("DOMContentLoaded", function() {
         document.removeEventListener("DOMContentLoaded", arguments.callee, false);
         Click.domready.run();
       }, false);

       // A fallback to window.onload, that will always work
 			window.addEventListener( "load",  Click.domready.run, false );

     // If IE event model is used
     } else if ( document.attachEvent ) {
       // ensure firing before onload, maybe late but safe also for iframes
       document.attachEvent("onreadystatechange", function() {
         if (document.readyState === "complete") {
           document.detachEvent("onreadystatechange", arguments.callee);
           Click.domready.run();
         }
       });

 			// A fallback to window.onload, that will always work
 			window.attachEvent( "onload", Click.domready.run );

       // If IE and not a frame continually check to see if the document is ready
 			var toplevel = false;
       try {
 				toplevel = window.frameElement == null;
 			} catch(e) {}

 			if ( document.documentElement.doScroll && toplevel) {
 	      (function () {
     	    try {
     			  document.documentElement.doScroll('left');
     		  } catch (e) {
      			  setTimeout(arguments.callee, 1);
     			  return;
  		      }
 		      // Dom is ready, run events
 		      Click.domready.run();
 	      })();
       }
     }
 })();

 /**
  * Usage: Call Click.addLoadEvent passing in a function to invoke when the DOM is
  * ready:
  *
  *    Example 1:
  *    function something() {
  *       // do something
  *    }
  *    Click.addLoadEvent(something);
  *
  *    Example 2:
  *    Click.addLoadEvent(function() {
  *        // do something
  *    });
  */
 Click.addLoadEvent = function(func) {
     // If dom is ready, fire event and return
     if (Click.domready.ready) {
         return func();
     }
     Click.domready.events.push(func);
 };

 addLoadEvent=Click.addLoadEvent;


 Click.setFocus = function(id) {
     var field = document.getElementById(id);
     if (field && field.focus && field.type != "hidden" && field.disabled != true) {
     	try {
 			field.focus();
 		} catch (err) {
 		}
     }
 };

 Click.trim = function(str) {
     while (str.charAt(0) == (" ")) {
         str = str.substring(1);
       }
       while (str.charAt(str.length - 1) == " ") {
           str = str.substring(0,str.length-1);
       }
       return str;
 };

 Click.hasClass=function(element,cls){
     var className=element.className;
     if(className) {
         return new RegExp('\\b'+cls+'\\b').test(className);
     }
     return false;
 };

 Click.addClass=function(element,cls){
     if(!Click.hasClass(element,cls)) {
         element.className += element.className ? ' ' + cls : cls;
     }
 };

 Click.removeClass=function(element,cls){
     var className=element.className;
     if(!className) return;

     if(className.indexOf(' ')<0) {
         element.className='';
         return;
     }

     var rep = new RegExp('(^|\\s)' + cls + '(?:\\s|$)');
     element.className = className.replace(rep, '$1');
 };

 Click.setFieldValidClass=function(field) {
     Click.removeClass(field,'error');
 };

 Click.setFieldErrorClass=function(field) {
     Click.addClass(field,'error');
 };

 Click.validateTextField = function(id, required, minLength, maxLength, msgs) {
     var field = document.getElementById(id);
     if (field) {
         var value = Click.trim(field.value);
         if (required) {
             if (value.length == 0) {
                 Click.setFieldErrorClass(field);
                 return msgs[0];
             }
         }
         if (required && minLength > 0) {
             if (value.length < minLength) {
                 Click.setFieldErrorClass(field);
                 return msgs[1];
             }
         }
         if (maxLength > 0) {
             if (value.length > maxLength) {
                 Click.setFieldErrorClass(field);
                 return msgs[2];
             }
         }
         Click.setFieldValidClass(field);
         return null;
     } else {
         return 'Field ' + id + ' not found.';
     }
 };

 Click.validateCheckbox = function(id, required, msgs) {
     var field = document.getElementById(id);
     if (field) {
         if (required) {
             if (field.checked) {
                 return null;
             } else {
                 return msgs[0];
             }
         }
     } else {
         return 'Field ' + id + ' not found.';
     }
 };

 Click.validateSelect = function(id, defaultValue, required, msgs) {
     var field = document.getElementById(id);
     if (field) {
         if (required) {
             var value = field.value;
             if (value != defaultValue) {
                 Click.setFieldValidClass(field);
                 return null;
             } else {
                 Click.setFieldErrorClass(field);
                 return msgs[0];
             }
         }
     } else {
         return 'Field ' + id + ' not found.';
     }
 };

 Click.validateRadioGroup = function(radioName, formId, required, msgs) {
     if(required){
         var form = document.getElementById(formId);
         if(form){
             var path=form[radioName];
             for (i = 0; i < path.length; i++){
                 if (path[i].checked){
                     return null;
                 }
             }
             return msgs[0];
         }
     }
 };

 Click.validateFileField = function(id, required, msgs) {
     var field = document.getElementById(id);
     if (field) {
         var value = Click.trim(field.value);
         if (required) {
             if (value.length == 0) {
                 Click.setFieldErrorClass(field);
                 return msgs[0];
             }
         }
     } else {
         return 'Field ' + id + ' not found.';
     }
 };

 Click.validateForm = function(msgs, id, align, style) {
     var errorsHtml = '';
     var focusFieldId = null;

     for (i = 0; i < msgs.length; i++) {
         var value = msgs[i];
         if (value != null) {
             var index = value.lastIndexOf('|');
             var fieldMsg = value.substring(0, index);
             var fieldId = value.substring(index + 1);

             if (focusFieldId == null) {
                 focusFieldId = fieldId;
             }

             errorsHtml += '<tr class="errors"><td class="errors" align="';
             errorsHtml += align;
 			if (style != null) {
             	errorsHtml += '" style="';
 				errorsHtml += style;
             }
             errorsHtml += '">';
             errorsHtml += '<a class="error" href="javascript:Click.setFocus(\'';
             errorsHtml += fieldId;
             errorsHtml += '\');">';
             errorsHtml += fieldMsg;
             errorsHtml += '</a>';
             errorsHtml += '</td></tr>';
         }
     }

     if (errorsHtml.length > 0) {
         errorsHtml = '<table class="errors">' + errorsHtml + '</table>';
         //alert(errorsHtml);

         document.getElementById(id + '-errorsDiv').innerHTML = errorsHtml;
         document.getElementById(id + '-errorsTr').style.display = 'inline';

         Click.setFocus(focusFieldId);

         return false;

     } else {
         return true;
     }
 };

 /**
  * Submit the form and checks that no field or button is called 'submit' as
  * it causes JS exceptions.
  *
  * Usage: <input onclick="Click.submit(form)">
  */
 Click.submit=function(form) {
     if (typeof form == 'undefined') {
         alert('Error: form is undefined. Usage: Click.submit(form)');
         return false;
     }

     if (form) {
         var formElements = form.elements;
         for (var i=0; i < formElements.length; i++) {
             var el = formElements[i];
     		    if(el.name=='submit'){
                 alert('Error: In order to submit the Form through JavaScript, buttons and fields must not be named "submit". Please rename the button/field called "submit".');
                 return false;
             }
         }
     }
     form.submit();
     return true;
 };
	// Licensed to the Apache Software Foundation (ASF) under one
	// or more contributor license agreements. See the NOTICE file
	// distributed with this work for additional information
	// regarding copyright ownership. The ASF licenses this file
	// to you under the Apache License, Version 2.0 (the
	// "License"); you may not use this file except in compliance
	// with the License. You may obtain a copy of the License at
	//
	// http://www.apache.org/licenses/LICENSE-2.0
	//
	// Unless required by applicable law or agreed to in writing,
	// software distributed under the License is distributed on an
	// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
	// KIND, either express or implied. See the License for the
	// specific language governing permissions and limitations
	// under the License.

	// Ensure Click namespace exists
	if ( typeof Click == 'undefined' )
	Click = {};

	/**
	* DomReady state variables.
	*/
	if ( typeof Click.domready == 'undefined' ) {
	Click.domready = {
	events: [],
	ready: false,
	run : function() {
	if ( !document.body ) {
	// If body is null run this function after timeout
	return setTimeout(arguments.callee, 13);
	}
	Click.domready.ready=true;
	var e;
	while(e = Click.domready.events.shift()) {
	e();
	}
	}
	}
	}

	/**
	* This function is based on work done by Dean Edwards, Diego Perini,
	* Matthias Miller, John Resig and Jesse Skinner.
	*
	* http://dean.edwards.name/weblog/2006/06/again/
	* http://simonwillison.net/2004/May/26/addLoadEvent/
	* http://javascript.nwbox.com/IEContentLoaded/
	* http://www.thefutureoftheweb.com/blog/adddomloadevent/
	* http://www.subprint.com/blog/demystifying-the-dom-ready-event-method/
	*/
	(function() {
	// Handle DOMContentLoaded compliant browsers.
	if (document.addEventListener) {
	document.addEventListener("DOMContentLoaded", function() {
	document.removeEventListener("DOMContentLoaded", arguments.callee, false);
	Click.domready.run();
	}, false);

	// A fallback to window.onload, that will always work
	window.addEventListener( "load", Click.domready.run, false );

	// If IE event model is used
	} else if ( document.attachEvent ) {
	// ensure firing before onload, maybe late but safe also for iframes
	document.attachEvent("onreadystatechange", function() {
	if (document.readyState === "complete") {
	document.detachEvent("onreadystatechange", arguments.callee);
	Click.domready.run();
	}
	});

	// A fallback to window.onload, that will always work
	window.attachEvent( "onload", Click.domready.run );

	// If IE and not a frame continually check to see if the document is ready
	var toplevel = false;
	try {
	toplevel = window.frameElement == null;
	} catch(e) {}

	if ( document.documentElement.doScroll && toplevel) {
	(function () {
	try {
	document.documentElement.doScroll('left');
	} catch (e) {
	setTimeout(arguments.callee, 1);
	return;
	}
	// Dom is ready, run events
	Click.domready.run();
	})();
	}
	}
	})();

	/**
	* Usage: Call Click.addLoadEvent passing in a function to invoke when the DOM is
	* ready:
	*
	* Example 1:
	* function something() {
	* // do something
	* }
	* Click.addLoadEvent(something);
	*
	* Example 2:
	* Click.addLoadEvent(function() {
	* // do something
	* });
	*/
	Click.addLoadEvent = function(func) {
	// If dom is ready, fire event and return
	if (Click.domready.ready) {
	return func();
	}
	Click.domready.events.push(func);
	};

	addLoadEvent=Click.addLoadEvent;


	Click.setFocus = function(id) {
	var field = document.getElementById(id);
	if (field && field.focus && field.type != "hidden" && field.disabled != true) {
	try {
	field.focus();
	} catch (err) {
	}
	}
	};

	Click.trim = function(str) {
	while (str.charAt(0) == (" ")) {
	str = str.substring(1);
	}
	while (str.charAt(str.length - 1) == " ") {
	str = str.substring(0,str.length-1);
	}
	return str;
	};

	Click.hasClass=function(element,cls){
	var className=element.className;
	if(className) {
	return new RegExp('\\b'+cls+'\\b').test(className);
	}
	return false;
	};

	Click.addClass=function(element,cls){
	if(!Click.hasClass(element,cls)) {
	element.className += element.className ? ' ' + cls : cls;
	}
	};

	Click.removeClass=function(element,cls){
	var className=element.className;
	if(!className) return;

	if(className.indexOf(' ')<0) {
	element.className='';
	return;
	}

	var rep = new RegExp('(^\|\\s)' + cls + '(?:\\s\|$)');
	element.className = className.replace(rep, '$1');
	};

	Click.setFieldValidClass=function(field) {
	Click.removeClass(field,'error');
	};

	Click.setFieldErrorClass=function(field) {
	Click.addClass(field,'error');
	};

	Click.validateTextField = function(id, required, minLength, maxLength, msgs) {
	var field = document.getElementById(id);
	if (field) {
	var value = Click.trim(field.value);
	if (required) {
	if (value.length == 0) {
	Click.setFieldErrorClass(field);
	return msgs[0];
	}
	}
	if (required && minLength > 0) {
	if (value.length < minLength) {
	Click.setFieldErrorClass(field);
	return msgs[1];
	}
	}
	if (maxLength > 0) {
	if (value.length > maxLength) {
	Click.setFieldErrorClass(field);
	return msgs[2];
	}
	}
	Click.setFieldValidClass(field);
	return null;
	} else {
	return 'Field ' + id + ' not found.';
	}
	};

	Click.validateCheckbox = function(id, required, msgs) {
	var field = document.getElementById(id);
	if (field) {
	if (required) {
	if (field.checked) {
	return null;
	} else {
	return msgs[0];
	}
	}
	} else {
	return 'Field ' + id + ' not found.';
	}
	};

	Click.validateSelect = function(id, defaultValue, required, msgs) {
	var field = document.getElementById(id);
	if (field) {
	if (required) {
	var value = field.value;
	if (value != defaultValue) {
	Click.setFieldValidClass(field);
	return null;
	} else {
	Click.setFieldErrorClass(field);
	return msgs[0];
	}
	}
	} else {
	return 'Field ' + id + ' not found.';
	}
	};

	Click.validateRadioGroup = function(radioName, formId, required, msgs) {
	if(required){
	var form = document.getElementById(formId);
	if(form){
	var path=form[radioName];
	for (i = 0; i < path.length; i++){
	if (path[i].checked){
	return null;
	}
	}
	return msgs[0];
	}
	}
	};

	Click.validateFileField = function(id, required, msgs) {
	var field = document.getElementById(id);
	if (field) {
	var value = Click.trim(field.value);
	if (required) {
	if (value.length == 0) {
	Click.setFieldErrorClass(field);
	return msgs[0];
	}
	}
	} else {
	return 'Field ' + id + ' not found.';
	}
	};

	Click.validateForm = function(msgs, id, align, style) {
	var errorsHtml = '';
	var focusFieldId = null;

	for (i = 0; i < msgs.length; i++) {
	var value = msgs[i];
	if (value != null) {
	var index = value.lastIndexOf('\|');
	var fieldMsg = value.substring(0, index);
	var fieldId = value.substring(index + 1);

	if (focusFieldId == null) {
	focusFieldId = fieldId;
	}

	errorsHtml += '<tr class="errors"><td class="errors" align="';
	errorsHtml += align;
	if (style != null) {
	errorsHtml += '" style="';
	errorsHtml += style;
	}
	errorsHtml += '">';
	errorsHtml += '<a class="error" href="javascript:Click.setFocus(\'';
	errorsHtml += fieldId;
	errorsHtml += '\');">';
	errorsHtml += fieldMsg;
	errorsHtml += '</a>';
	errorsHtml += '</td></tr>';
	}
	}

	if (errorsHtml.length > 0) {
	errorsHtml = '<table class="errors">' + errorsHtml + '</table>';
	//alert(errorsHtml);

	document.getElementById(id + '-errorsDiv').innerHTML = errorsHtml;
	document.getElementById(id + '-errorsTr').style.display = 'inline';

	Click.setFocus(focusFieldId);

	return false;

	} else {
	return true;
	}
	};

	/**
	* Submit the form and checks that no field or button is called 'submit' as
	* it causes JS exceptions.
	*
	* Usage: <input onclick="Click.submit(form)">
	*/
	Click.submit=function(form) {
	if (typeof form == 'undefined') {
	alert('Error: form is undefined. Usage: Click.submit(form)');
	return false;
	}

	if (form) {
	var formElements = form.elements;
	for (var i=0; i < formElements.length; i++) {
	var el = formElements[i];
	if(el.name=='submit'){
	alert('Error: In order to submit the Form through JavaScript, buttons and fields must not be named "submit". Please rename the button/field called "submit".');
	return false;
	}
	}
	}
	form.submit();
	return true;
	};