/************************************************************************************************************* utils.js general purpose javascript functions how to use: =========== include this script in the page: <script language="JavaScript" type="text/javascript" src="../Static/Include/utils.js"></script> the script will create an object named ibpUtils (or window.ibpUtils) all functions are the object's methods result=ibpUtils.fnName(); ibpUtils Properties ========================= ibpUtils functions ================= name description ---- ----------- general -------- isSet is parame set isEmpty is parame empty isNum is numeric isInteger is integer isArray is element an array isObject is element an object ntz make sure param is not null or undefined toBoolean get boolean value escapeJs escape string for use in javascript enEscape js escape + replace for + to %2B (to suit with Java) encodeURL make sure value is url encoded. do not encode if already encoded decodeURL decode URL compareVals compare values by type forceSameHostOnAllFrames force same host for all frames on page String functions --------- getNthIndexOf get the nth position of an expression startsWith check if a string starts with another string endsWith check if a string ends with another string trim trims spaces in the beggining and end of the string enParseInt parse integer from string getRadioValue get selected value of radio buttons group setRadioValue set value of radio buttons group getValueOf get element's value setValueOf set element's value openPopupWindow open a window and set it's focus openPopupWindowWithShift check if ShiftKey is pressed and then call to openPopupWindow closeOnEsc close window on escape areValuesEqual check if value tst is equal to value vals setSelectedOptions set selected options is select element to one or more values in vals setPageTitle set the title of the document absoluteRedirect redirect to a given url - handle popup and hidden pages setWinLocation load the window with specific url sendFormRequest send request using a fictive form getBody get body object setBodyStyle set body style attribute DOM elemnets functions ------------------------- objectOrGetId get object by id getTableTbody for a given table the function returns reference to its TBODY elemnt(even if no such tag in the HTML source) getElTr for a given element in a table returns a reference to the TR element. getElTable for a given element in a table returns a reference to the table element getWindowPos get window position and dimentions getCompatMode get compatability mode getElementsByTagsNames returns an array of all the child nodes of an element filtered by a list of tagNames. Cross browsers events functions --------------------------------- evtGetCBEvent build a cross browser event object evtAddEvent attach event to element - cross browser evtRemoveEvent remove event from element - cross browser evtAddEventByTagName attach event to elements by their tag name appendEvent append event to an existing one (deprecated) Gui functions -------------- elmntContetsChangeGui gets a tag like div,table or form and disables/enables all the controlls in it elmntToggleClass toggle class name of an element elmntToggleImg toggle image source and title elmntShowHide toggles element's display style - shows or hides the element elmntShowHideAdvanced toggles elements display by tag name and container elmntIsVisible is element visible setPreviewImg set preview image by an attribute in a select element setZIndex Set zIndex property elmntResize gets an elemenet id and changes the width and heigt styles. elmntShiftBy gets an elemenet id and moves it by specified pixels (relative movement) elmntMove gets an elemenet id and locate in a new posotion (absolute movement) + optional resize it elmntAbsPos gets an elemenet id and calc the absolute position of it *absolute=relative to upper-left window's corner. elmntActualHeight get actual height elmntActualWidth get actual width elmntBackupChildChecks backup element's child checkboxes and options values. goes with elmntRestoreChildChecks and used when dynamically switching elements in the document elmntRestoreChildChecks restore element's child checkboxes and options values elmntSelectFirst select the first element in the document elmntSelect select a given element elmntGetParentByTagName search for parent element by tag name elmntRemove remove element elmntScrollIntoView scroll to the element so it's visible elmntSetInnerText set element inner text elmntImportForSubmit import elements between forms before submit elmntToggleAdvancedOptions show and hide advanced options floating iFrame (hidden iframe, that will serve as popup) ------------------------------------------------------------------ ifrShowFloatingIfr ifrCalcFloatingPosotion claculates the relative position of the div to an element ifrKeepInWindow makes changes in the div position if he fets out of the window ifrHandleAttributes insert for an iframe the src value or writes the html itself getIfrFromDiv search for an iframe in a div container, returns the iframe if found, else the passed element. ifrCreate create an iframe with id & name of the passed parameter- FOR IE5.5 ONLY! array functions --------------- isInArray get item and array, and check if the item exists in the array doubleArray double one dimension array into two dimension array ex: arr{item1,item2,...}-->>arr{{item1,item1},{item2,item2},...} date functions --------------- getDateFromElements get a date object from date elements (yy, mm, dd, ..) formatAsDateTime formats a date according to custom/default pattern. query string ------------ addQueryStringParam add query string parameter to path addQueryStringParamToEnd append param value pair to end of path getQueryString get query string on client side getQueryStringParam parse a specific query string parameter on the client side getBaseUrl get base url from window location getFolderFromUrl get the folder from the url getFileFromUrl get the file from the url qryStringToArray convert qry string into a 2 dimention array (encodes values) qryStringFromArray convert a 2 dimention array to a query string (encodes values) separatedListToArray convert a separated list into a 1 dimention array separatedListFromArray convert a 1 dimention array into a separated list isInSeparatedList is value in a separated list? executing in hidden frame -------------------------- (your page should have an iframe or layer, or be part of a frameset with a hidden one) execAsync run async exec and flag the form if passed execAsyncFrame run async exec and flag the form if passed - a hidden frame in a frameset callbackAsync runs the callback function. called from the hidden frame clearIFrameSrc called from container page: clear iframe location - refresh would run it again clearCurrFrameSrc called from frame: clear iframe location - refresh would run it again flagFormAsync flag form for async execution isExecAsync check if form may be submitted - if not during async execution execAsyncOnComboChange run async exec on combo change getParentWin returns the parent window defaultCallBack a general purpos call back function confirmActionHidden confirm action in a hidden frame limit text area length ----------------------- limitTextLength limit length in textarea - onkeypress chunkTextLength limit length in textarea - onblur limit input ----------------------- limitInputInteger limit input to integers only limitInputNumeric limit input to numeric only list functions - for use in assigning items between lists ---------------------------------------------------------- listMoveSelectedItems move selected item between lists listSortItems sort list items listReplaceItems replace 2 items within a list listAllItems list all items into a text element listMoveOptions move selected options in list listRefillM2MLists refill 2 selects for Many to Many connections listRefillList refills a givven list. tables functions ------------------------------------------------------------- tblSortTableEvt sort table - for use from event tblSortTableByEl sort table - by an element in a header td tblSortTable sort table tblMoveTableRow move a row in a table in a desired direction (up/down) tblSwitchTableRows switch table rows tblGetRowIndex returns the tr index in the tbody.rows collection tblReassignRowsClass re assign classes to rows (odd / even) tblReassignSortStatus set sort status image tabs ---------------------------------------------------------------- setSelectedTab set the selected tab in tabs collection setSelectedTabByEvt same, used when event is attached to the header tr handleTabMouseInOut handle mouse in/out event handleTabMouseInEvt handle mouse in event handleTabMouseOutEvt handle mouse out event ticker (scrolling messages) --------------------------------------------------------------- ticGlobal global ticker object ticNs4marquee build ns 4 elements ticNs4slide build ns 4 elements ticNs6marquee build ns 6 elements ticNs6slide build ns 6 elements ticInit init ticker ticWriteElements write eleemnts - called when the page is written Drag & Drop functions --------------------------------------------------------------- GENERAL: in order for an elemnt to be dragable it must have: 1. attribute enaDragable="1" 2. style="position:absolute" 3. If the element has border, it must be numeric. 4. on the page load run the dragInit(); FUNCTIONS: dragInit: init function to set the global variable & attach functions to documnet events dragCatch: private function (start drag). dragSetSelectedElmnt: private function (put draged elemnt in memory) dragRelease: end drag - clear memory + put last position in memory dragIt: private function (dragging) Coookies function --------------------------------------------------------------- setCookie Function to create or update a cookie. getCookie Function to return the value of the cookie specified by "name" (null if not found) deleteCookie Function to delete a cookie. (Sets expiration date to start of epoch) /************************************************************************************************************* original required.js this functions are requiter for soem tags in enfoemia tag library function names and implementation are not to be changes !!! functions ========= name description ---- ----------- fckEditorGetInstance get FCK editor instance fckEditorAvailable check if FCKEditor object is available fckEditorGetContent get FCK editor content (HTML) fckEditorGetContentLength get FCK editor content (HTML) length fckEditorSetFocus set FCK editor focus CalendarPopup popup calendar PopulateDates repopulate date select list when month or year changes confirmDelete prompt user to confirm delete toggleStatusDateFields toggle the visibility of status date fields *************************************************************************************************************/ //ibpUtils construstor function function ibpUtilsConstrustor() { /*--------------------------------------------------------------------------------------- Properties ---------------------------------------------------------------------------------------*/ /*--------------------------------------------------------------------------------------- general ---------------------------------------------------------------------------------------*/ //is parame set var isSet=function(prm) { var und; return(prm!=und && prm!=null); } this.isSet=isSet; //is parame empty (undefined / null / "") var isEmpty=function(prm) { return(!isSet(prm) || ((typeof prm).toLowerCase()=="string" && prm.length==0)); } this.isEmpty=isEmpty; //is numeric var isNum=function (v) { if(isEmpty(v))return false; return (v.toString() && !/\D/.test(v)); } this.isNum=isNum; //is integer var isInteger=function (sValue,bSigned) { if(isEmpty(sValue))return false; var re=new RegExp("^"+((bSigned)?"[\\-\\+]?":"")+"\\d+$"); return re.test(sValue); } this.isInteger=isInteger; //is element an array var isArray=function(elmnt) { if(!isSet(elmnt))return false; return (elmnt.constructor==Array); } this.isArray=isArray; //is element an object var isObject=function(elmnt) { if(!isSet(elmnt))return false; return (elmnt.constructor==Object || typeof elmnt == "object"); } this.isObject=isObject; //make sure param is not null or undefined var ntz=function(prm,def) { if(!isSet(def))def=""; return(isEmpty(prm)?def:prm); } this.ntz=ntz; //get boolean value var toBoolean=function(prm,def) { if(!isSet(def))def=false; if(prm==true || prm==1) return true; if(prm==false || prm==0) return false; prm=ntz(prm).toLowerCase(); if(prm=="true" || prm=="1") return true; if(prm=="false" || prm=="0") return false; return def; } this.toBoolean=toBoolean; //escape string for use in javascript var escapeJs=function(text) { if(isEmpty(text))return ""; text=text.replace("'","\\'"); text=text.replace("\"","\\\""); text=text.replace("\n","\\n"); text=text.replace("\r","\\r"); return text; } this.escapeJs=escapeJs; //js escape + replace for + to %2B (to suit with Java) //**** there may be a bug here - '+' encods to %2B, but we realy need to encode a space - %20 //NOTE: should not be used for URLs var enEscape=function(prm) { prm=escape(prm);//javascript escape prm=prm.replace(/\+/g,"%2B");//replace + with %2B (ie & ns6+ does not do it) return prm; } this.enEscape=enEscape; //make sure value is url encoded. do not encode if already encoded var encodeURL=function(prm) { if(isEmpty(prm))return prm; else return encodeURIComponent(prm); } this.encodeURL=encodeURL; //decode URL var decodeURL=function(prm) { if(isEmpty(prm))return prm; else return decodeURIComponent(prm); } this.decodeURL=decodeURL; /* compare values by type params: val1 - first val val2 - 2nd val type - compare type: numeric / date@format / text (def) the @format part in date is optional. format may be mm/dd/yyyy, dd/mm/yyyy or '-' instead of '/' returns: 0 if equal, 1 if val1>val2, -1 else */ var compareVals=function(val1,val2,type) { if(isEmpty(type))type="text"; type=type.toLowerCase(); if(type=="numeric") { val1=1*val1; val2=1*val2; } else if(type.indexOf("date")==0) { var fmt=""; //check for date format if(type.indexOf("@")!=-1) { fmt=type.split("@")[1]; } //if(!isEmpty(fmt)) if(fmt!="") { var dt=isSet(ibpValidation) ? ibpValidation.isDate(val1,fmt,true) : null; val1=dt?dt.getTime():null; dt=isSet(ibpValidation) ? ibpValidation.isDate(val2,fmt,true) : null; val2=dt?dt.getTime():null; } //free format (based on Date.parse()) else { val1=Date.parse(val1); val2=Date.parse(val2); } } if(val1==val2)return 0; if(val1>val2)return 1; else return -1; } this.compareVals=compareVals; /* force same host for all frames on page. if top has another host - sets self location to top */ var forceSameHostOnAllFrames=function() { var sameHost=true; var PERMISSION_DENIED=-2146828218; try { sameHost = !(top != self && top.location.host!=self.location.host); } catch(e) { if(e.number==PERMISSION_DENIED) sameHost=false; /* alert(e.number); alert(e.description); alert(e.name); alert(e.message); */ } if(!sameHost) top.location=self.location; } this.forceSameHostOnAllFrames=forceSameHostOnAllFrames; /* get the nth position of an expression params: text - text to search expr - expression to find n - nth position returns - pos, or -1 if not found */ var getNthIndexOf=function(text,expr,n) { if(isEmpty(text)||isEmpty(expr)||!isNum(n))return -1; var pos=0; var len=expr.length; for(var i=1;i<=n;i++) { pos=text.indexOf(expr,pos+len); if(pos==-1)return -1; } return pos; } this.getNthIndexOf=getNthIndexOf; /* check if a string starts with another string */ var startsWith=function(str,prefix) { var preLen=prefix.length; var strLen=str.length; if(preLen>str.length) return false; return(str.substr(0,preLen)==prefix) } this.startsWith=startsWith; /* check if a string ends with another string */ var endsWith=function(str,suffix) { var sufLen=suffix.length; var strLen=str.length; if(sufLen>str.length) return false; return(str.substr(strLen-sufLen,sufLen)==suffix) } this.endsWith=endsWith; /* trims spaces in the beggining and end of the string */ var trim=function(str) { str=""+str; str = str.replace(/^\s+|\s+$/g,""); //trim leading   while(str.charCodeAt(0)==160) { str=str.substring(1); str = str.replace(/^\s+|\s+$/g,""); } //trim trailing   while(str.charCodeAt(str.length-1)==160) { str=str.substring(1); str = str.replace(/^\s+|\s+$/g,""); } return str; } this.trim=trim; /* parse integer from string */ var enParseInt=function(val) { if(isEmpty(val))return NaN; //trim val=trim(val); //has O? var startZro=val.indexOf("0")==0; //trim leading 0s val=val.replace(/^0*/g,""); if(isEmpty(val))return startZro ? 0 : NaN; val=parseInt(val); return isNaN(val) && startZro ? 0 : val; } this.enParseInt=enParseInt; //get selected value of radio buttons group var getRadioValue=function(r){ if(isEmpty(r))return null; r=objectOrGetId(r); //check if an array var len=r.length; if(len>0) { if(r[0].type!="radio")return null; //loop through multiple options for(var intLoop=0;intLoop0) { if(r[0].type!="radio")return false; //loop through multiple options for(var intLoop=0;intLoop0 && oElement[0].type=="radio")isRadio=true; } catch(e){} return isRadio ? getRadioValue(oElement) : _getValueOf(oElement); } //expose this.getValueOf=getValueOf; //expose this.getValueOf=getValueOf; var _getValueOf=function(oElement) { var sReturnValue = null; if(!oElement)return sReturnValue; switch (oElement.type){ case "text" : case "textarea" : case "file" : case "password" : case "hidden" : sReturnValue = oElement.value; break; case "select-one" : sReturnValue = oElement.options[oElement.selectedIndex].value; break; case "select-multiple" : var i,c=0, iOptions = oElement.options.length; for(i=0; i1)sReturnValue+=","; sReturnValue+=oElement.options[i].value; } } break; case "radio" : case "checkbox" : if(oElement.checked) { sReturnValue = oElement.value ? oElement.value : true; }else sReturnValue=false; break; } return sReturnValue; } //set element's value var setValueOf=function(oElement,value) { if(isEmpty(oElement))return false; oElement=objectOrGetId(oElement); //check if an array and element type (radio only) var len=oElement.length; if(len>0 && oElement[0].type=="radio") return setRadioValue(oElement,value); return _setValueOf(oElement,value); } this.setValueOf=setValueOf; var _setValueOf=function(oElement,value) { if(!isSet(oElement))return false; oElement=objectOrGetId(oElement); switch (oElement.type) { case "text" : case "textarea" : case "file" : case "password" : case "hidden" : oElement.value=value; break; case "select-one" : case "select-multiple" : setSelectedOptions(oElement,value); break; case "radio" : case "checkbox" : oElement.checked=(value?true:false); break; } return true; } /* open a window and set it's focus path - url to open target - target window name (def 'enDefaultTarget') atts - optional atts string width - win width, when atts is null height - win height, when atts is null retWin - return the window object (def false) center - center in window (def true) newIfExsists - if there is a window in that name, open in new window (def false) adds the following params: ibpPopup - in popup page ibpRand - random value (to enformce refresh) */ var openPopupWindow=function(path,target,atts,width,height,retWin,center,newIfExsists) { //def size if(isEmpty(width) || !isInteger(width))width="500"; if(isEmpty(height) || !isInteger(height))height="480"; //center in window if(!isSet(center))center=true; if(!isSet(newIfExsists))newIfExsists=false; var centerPos=""; //center in window if(center) { var winPos=getWindowPos(window.top); var left=0.5*(winPos.width-enParseInt(width)); var top=0.5*(winPos.height-enParseInt(height)); if(left>=0)centerPos+=",left="+left; if(top>=0)centerPos+=",top="+top; } //build attributes if(isEmpty(atts)) { atts="width="+width; atts+=",height="+height; if(center)atts+=centerPos; atts+=",resizable=1,status=1,menubar=0,scrollbars=1,fullscreen=0"; } //insert default width, height and pos else { if(atts.toLowerCase().indexOf("width=")==-1)atts+=",width="+width; if(atts.toLowerCase().indexOf("height=")==-1)atts+=",height="+height; if(center && atts.toLowerCase().indexOf("top=")==-1 && atts.toLowerCase().indexOf("left=")==-1)atts+=centerPos; } //add popup and random parameter to path path=addQueryStringParam(path,"ibpPopup","1"); path=addQueryStringParam(path,"ibpRand",Math.random()); //def target if(isEmpty(target))target="enDefaultTarget"; //handle the case when the caller is a popup with name = target if(newIfExsists) if(window.name==target || window.top.name==target)target="_blank"; try { if(this.openedPopup.name==target && this.attsPopup!=atts) { this.openedPopup.close(); } } catch(e){} this.attsPopup = atts ; this.openedPopup=window.open(path,target,atts); this.openedPopup.focus(); if(retWin)return this.openedPopup; } //expose this.openPopupWindow=openPopupWindow; /* check if the shiftKey is pressed and then call to openPopupWindow */ var openPopupWindowWithShift=function(e) { e=evtGetCBEvent(e); var currPath=e.currentTarget.getAttribute("href"); var currWidth=e.currentTarget.getAttribute("enWidth"); var currHeight=e.currentTarget.getAttribute("enHeight"); var target=e.currentTarget.getAttribute("target"); if(isEmpty(target)) target="enDefaultTarget" var currTarget=e.shiftKey?"_blank":target; e.cancelEvent(false); openPopupWindow(currPath,currTarget,null,currWidth,currHeight) } //expose this.openPopupWindowWithShift=openPopupWindowWithShift; /* close window on escape how to use: ibpUtils.evtAddEvent(document,"keyup",ibpUtils.closeOnEsc); */ var closeOnEsc=function(e) { //get event e=evtGetCBEvent(e); //get ascii code if(e.keyCode==27)window.top.close(); } this.closeOnEsc=closeOnEsc; //check if value tst is equal to value vals //or to any of the values in array vals[] var areValuesEqual=function(tst,vals){ if(tst==null || vals==null)return false; if(vals.constructor==Array){ for(var i=0;i