/** public void handleException throws Error : Catchall method to route all CobaltError instances * appropriately, and just throw every other kind like normal. * @param Error exception Exception to handle */ handleException = function(exception) { if (exception instanceof CobaltError) exception.handleException(); else throw exception; } /** public class CobaltError : Base JavaScript error for all other cblt errors to subclass. */ function CobaltError() { this.titleKey = "INCORRECT.INFORMATION"; this.messageKeys = ["ERRORMESSAGE.INCORRECT.DATA"]; } /** public void handleException : Default implementation of method to handle errors. */ CobaltError.prototype.handleException = function() {} /** public static class FormUtility : Useful mechanisms for validating forms. */ FormUtility = { /** public static String HIGHLIGHT_COLOR : Default highlight color for error fields */ HIGHLIGHT_COLOR : "#FFFF66", /** public static String LABEL_COLOR : Default label color relating to error fields */ LABEL_COLOR : "#FF0000", /** private Array highlightedFields : List of highlighted fields after validation fails */ highlightedFields : [], /** private Map initializedFieldVOs : Storage for lazy loaded FieldVOs, for performance */ initializedFieldVOs : {}, /** private Map sections : Storage for initted FieldVOs, keyed by section name */ sections : {}, /** public void changeFieldsColor : Change field backgrounds to the specified color. * @param Array fieldList List of fields to change color * @param String Hex color string, e.g. FF0000 */ changeFieldsColor : function(fieldList, color) { var currElem, currElemType; for (var i=0; i 500) fields.push(field); } return fields; }, /** public Map getRequiredFields : Get the set of required fields in a section. * @param HTMLElement section Form, div, etc. to search for required fields in * @return List of required fields */ getRequiredFields : function(section) { if (!section) return {}; if (!FormUtility.sections[section.id]) FormUtility.registerFields(section); return FormUtility.sections[section.id]["required"]; }, /** public void highlightFields : Highlight specified fields. * @param Array fieldList List of fields to highlight */ highlightFields : function(fieldList) { FormUtility.changeFieldsColor(fieldList, FormUtility.HIGHLIGHT_COLOR); FormUtility.highlightedFields = fieldList; }, /** public void colorLabels : Change the color of the label text for the specified fields. * @param Array fieldList List of fields to highlight */ colorLabels : function(fieldList) { FormUtility.changeLabelColor(fieldList, FormUtility.LABEL_COLOR); FormUtility.highlightedFields = fieldList; }, /** public void registerFields : Find and lazy load fields in a section, for performance. * @param HTMLElement section Form, div, etc. to register fields in */ registerFields : function(section) { if (section.tagName.toLowerCase() == "form") { var allFields = section.elements; } else { var allFields = FormUtility.getFieldsByTagName(section, "input"); allFields = allFields.concat(FormUtility.getFieldsByTagName(section, "textarea")); allFields = allFields.concat(FormUtility.getFieldsByTagName(section, "select")); } FormUtility.sections[section.id] = {}; FormUtility.sections[section.id]["formatted"] = {}; FormUtility.sections[section.id]["required"] = {}; for (var i=0; i). * @param String str String to check * @return True if string contains no HTML characters */ function hasNoHTML(str) { return hasNoCustom(str, "\"<>"); } /** public boolean hasNoCustom : Check if string contains none of the specified characters * @param String str String to check * @param String customBadChars Disallowed characters * @return True if string contains no custom characters */ function hasNoCustom(str, customBadChars) { if (!customBadChars) return true; var badCharsRE = new RegExp("^[^" + customBadChars + "]*$"); return badCharsRE.test(str); } /** public boolean isAssetName : Check if string meets MAMS asset name requirements. * @param String str String to check * @return True if string meets MAMS asset name requirements */ function isAssetName(str) { return _VALIDATION_ASSETNAME.test(str); } /** public boolean isLibraryName : Check if string meets MAMS library name requirements. * @param String str String to check * @return True if string meets MAMS library name requirements */ function isLibraryName(str) { return _VALIDATION_LIBRARYNAME.test(str); } /** public boolean isEmail : Check if string has a valid email address format. * @param String str String to check * @return True if string has a valid email address format */ function isEmail(str) { return _VALIDATION_EMAIL.test(str); } /** public boolean isAbsoluteUrl : Check if string is an absolute URL. * @param String str String to check * @return True if string is an absolute url */ function isAbsoluteUrl(str) { var protocolRE = /^[a-z]+:(\/\/)?/i; return protocolRE.test(str); } /** public boolean isSitePageUrl : Check if string is a site page or an external url. * @param String str String to check * @return True if string does not contain any "." chars */ function isSitePageUrl(str) { return (str.indexOf(".") == -1) ? true : false; } /** public boolean isPhoneFax : Check if string has a valid phone/fax format (includes alpha chars). * @param String str String to check * @return True if string has a valid phone/fax format */ function isPhoneFax(str) { return _VALIDATION_PHONEFAX.test(str); } /** public boolean isPhoneFax : Check if string has a valid phone/fax format (doesn't include alpha chars). * @param String str String to check * @return True if string has a valid phone/fax format */ function isNumericPhoneFax(str) { return _VALIDATION_NUMERIC_PHONEFAX.test(str); } /** public boolean isZip : Check if string has a valid zip format. * @param String str String to check * @return True if string has a valid zip format */ function isZip(str) { return _VALIDATION_ZIP.test(str); } /** public boolean isFreeformDate : Check if string has a valid date format, e.g. mm/dd/yyyy. * @param String str String to check * @return True if string has a valid date format */ var strGlobalDate = null; function isFreeformDate(str) { strGlobalDate = str; return _VALIDATION_DATE.test(str); } function isValidEndDate(str) { convertedGlobalDate = new Date(strGlobalDate); convertedGlobalDate = convertedGlobalDate.toLocaleDateString(); localizedGlobalDate = new Date(convertedGlobalDate); startDateMilliseconds = localizedGlobalDate.getTime(); endDate = new Date(str); endDate = endDate.toLocaleDateString(); localizedEndDate = new Date(endDate); endDateMilliseconds = localizedEndDate.getTime(); if(startDateMilliseconds > endDateMilliseconds) return false; if(isFreeformDate(str)) return true; } /** public boolean isYear : Check if year is valid. * @param String str Year to check * @return True if string is a valid year */ function isYear(str) { var _allyears = new RegExp("^" + _VALIDATION_DATE_ALLYEARS + "?$"); return _allyears.test(str); } /** public boolean isAddress : Check if string contains only valid address characters. * @param String str String to check * @return True if string contains valid characters */ function isAddress(str) { return _VALIDATION_ADDRESS.test(str); } /** public boolean isMoney : Check if string contains only valid monetary characters. * @param String str String to check * @return True if string contains valid characters */ function isMoney(str) { return _VALIDATION_MONEY.test(str); } /** public boolean isCity : Check if string contains only valid city characters. * @param String str String to check * @return True if string contains valid characters */ function isCity(str) { return _VALIDATION_CITY.test(str); } /** public boolean isOdometer : Check if string contains only valid odometer characters. * @param String str String to check * @return True if string contains valid characters */ function isOdometer(str) { return _VALIDATION_ODOMETER.test(str); } /** public boolean isLatLong : Check if string contains only valid latitude/longitude characters. * @param String str String to check * @return True if string contains valid characters */ function isLatLong(str) { return _VALIDATION_LATLONG.test(str); } /** public boolean isCCNumber : Check if string has valid credit card number format. * @param String str String to check * @return True if string has valid format */ function isCCNumber(str) { return _VALIDATION_CREDITCARDNUMBER.test(str); } /** public boolean isSSNumber : Check if string has valid social security number format. * @param String str String to check * @return True if string has valid format */ function isSSNumber(str) { return _VALIDATION_SSN.test(str); } /** public boolean isSSNumber : Check if string has no special characters except ". and _" * @param String str String to check * @return True if string has valid format */ function isTrackingVendor(str) { return _VALIDATION_VENDOR.test(str); } /** public boolean isSSNumber : Check if string has no special characters except ". and _" and blankspaces * @param String str String to check * @return True if string has valid format */ function isTrackingFields(str) { return _VALIDATION_TRACKINGFIELDS.test(str); } /** public boolean isCompleted : Check if field has a value entered/selected. * @param HTMLFormField field Field to check * @return True if field has been completed */ function isCompleted(field) { if (!field.type && field.length && field.className) return isSelected(field); switch (field.type) { case "text": case "textfield": case "textarea": case "password": case "file": case "hidden": return (isEmpty(field.value)) ? false : true; case "checkbox": case "radio": return (isChecked(field)) ? true : false; case "select-one": return (!isEmpty(field.value)) ? true : false; case "select-multiple": return (field.options.length) ? true : false; default: return true; } } /** public boolean isEmpty : Check if a string is empty or contains only whitespace chars. * @param String str String to check * @return True if string is empty */ function isEmpty(str) { if (str == "") return true; var emptyRE = new RegExp("^[" + _VALIDATION_BLANKCHARS + "]*$"); return emptyRE.test(str); } /** public boolean isSelected : Check if a grouped HTML form field has a selected value. * @param HTMLFormField field Field to check * @return True if field has a selected value */ function isSelected(thisSelect, defaultValue) { if (arguments.length == 1) var defaultValue = ""; var currentSelection = getSelected(thisSelect); if (!currentSelection || (currentSelection.value == null)) return false; else return (currentSelection.value != defaultValue); } /** public boolean isChecked : Check if a grouped HTML form field has a checked selection. * @param HTMLFormField field Field to check * @return True if field has a checked selection */ function isChecked(checkObj) { return (getSelected(checkObj)) ? true : false; } /** public boolean checkMaxLength : Check if a textarea's value is longer than its 'maxlength' attribute. * Truncates value if so. Should be called onKeyUp. * @param Event e Textfield's keyup event * @param HTMLFormField textarea Textarea to check * @return True if keyup event should be allowed */ function checkMaxLength(e, textarea) { var maxLength = parseInt(textarea.getAttribute("maxlength")); if ((e.keyCode < 48) && (e.keyCode != 32)) return true; if (textarea.value.length == maxLength) return false; if (textarea.value.length > maxLength) { textarea.value = textarea.value.substring(0, maxLength); return false; } return true; } /** public Map getSelected : Get a map of the selected index and value of the specified element. * Format: result.index; result.value * @param HTMLFormField thiselement Field to get selection of * @return Map of field's selection */ function getSelected(thiselement) { if (thiselement.type == "select-one") { var ind = thiselement.selectedIndex; if (ind >= 0) return {"index":ind, "value":thiselement.options[ind].value} } if (thiselement.length) { var isCheckbox = (thiselement[0].type == "checkbox") ? true : false; var values = new Array(); var indexes = new Array(); for (var i=0; i