JavaScript Functions

All functions presented herein are known to be cross-browser compatible for the following browsers only: IE 6.x, FireFox 1.5.0.4, Netscape 8.1 and Opera 9.

ezSelectionsFromObj(obj)

The “ezSelectionsFromObj(obj)” function is used to get the selections from a selection object known as the <select> element. The returned value is an array of selections in the form of the selected values or error conditions.

ezUUID$()

The “ezUUID$()” function returns a value that is known to be globally unique however it is not a traditional GUID or UUID value in the ColdFusion sense or otherwise. The value returned by this function is simply globally unique in that it should not return like values regardless of how often this function is called. You may consider this to be a temporally based globally unique value.

$(id, _frame)

The “$(id, _frame)” function takes two arguments, the “id” of the element whose Object instance is to be returned and the “_frame” the object inhabits if any. If the DHTML Object inhabits the default frame then the argument “_frame” can be a “null” value or simply not specified. Because this function will be used quite often the name of the function has been truncated to simply “$” rather than something like “GetElementByID” which would work the same but have a longer name. This function caches requests for Object instances to allow future requests for the same Object instances to be accelerated. If you wish to query for Object instances without those requests being cached then use the “_$(id, _frame)” function to do so. If the intent is to use dynamically created DHTML elements then use the “_$(id, _frame)” to query for them otherwise previously cached Object instances will be returned erroneously. Use the “flushCache$(oO)” function to clear the cache of Object instances that have been cached.

_$(id, _frame)

The “_$(id, _frame)” function takes the same two arguments as the “$(id, _frame)” function. Use the “_$(id, _frame)” function when the DHTML elements are known to be dynamically created or when caching is not desired.

ezClickRadioButton(id)

The “ezClickRadioButton(id)” function is used to process the action of clicking the radio button element which is to say the “checked = true” attribute is processed. The use of this function saves some coding effort since it is easier to use this function than to code the action each time this action is needed. The typical use of this function is at times when one wishes to cause a radio button to become checked at times when the radio button itself was not clicked by the user.

ezClientHeight()

The “ezClientHeight()” function returns the height of the client area for the browser window.

ezClientWidth()

The “ezClientWidth()” function returns the width of the client area for the browser window.

ezDisableAllButtonsLike(id, bool)

The “ezDisableAllButtonsLike(id, bool)” function takes an argument which is the “id” of the element. All BUTTON elements that have an “id” that contains the “id” of the argument will be disabled by this function. This function allows buttons to be given similar “id” attributes along functional lines to allow all BUTTON elements that share a similar naming convention to be disabled. Elements can be enabled by using the 2nd argument “bool” which is optional. When “bool” is false the elements are not disabled which means they are enabled otherwise when “bool” is not used the elements that match the criteria for this function are disabled.

ezElementPositonX(oObject)

The “ezElementPositonX(oObject)” function takes an argument which is an instance of an HTML Element such as a Div. The value returned from this function is the X position of the HTML Element whose instance is oObject.

ezElementPositonY(oObject)

The “ezElementPositonY(oObject)” function takes an argument which is an instance of an HTML Element such as a Div. The value returned from this function is the Y position of the HTML Element whose instance is oObject.

ezUnHookAllEventHandlers(anObj)

The “ezUnHookAllEventHandlers(anObj)” function takes one argument which is an Object instance for a DHTML element. This function unhooks the following event handlers for the element: “Abort, AfterUpdate, BeforeUnload, BeforeUpdate, Blur, Bounce, Click, Change, DataAvailable, DataSetChanged, DataSetComplete, DblClick, DragDrop, Error, ErrorUpdate, FilterChange, Focus, Help, KeyDown, KeyPress, KeyUp, Load, MouseDown, MouseMove, MouseOut, MouseOver, MouseUp, MouseWheel, Move, ReadyStateChange, Reset, Resize, RowEnter, RowExit, Scroll, Select, SelectStart, Start, Submit, Unload”. Additional event names can be added to the “const_events_list” variable if desired.

ezFullyQualifiedAppUrl()

The “ezFullyQualifiedAppUrl()” function returns the fully qualified URL where the application is running at the moment. The returned value is the window.location.href without the Query String sans the last element from the list that is delimited by the “/” character.

ezFullyQualifiedAppPrefix()

The “ezFullyQualifiedAppPrefix()” function returns the same value as the “ezFullyQualifiedAppUrl()” function except that the value that follows the “http://” symbol is “clusterized” in such a manner to allow the URL to always refer to the Cluster Manager for an ezCluster web server cluster.

ezCluster is a product that was also developed by Hierarchical Applications Limited that allows web server clusters to be constructed using nothing but the web servers themselves plus at least one database server but without the need for any Networking hardware or OS support. ezCluster provides the lowest cost solution for web server clustering there is because it requires no extra hardware other than the web servers that comprise the cluster plus at least one database server. ezCluster is U.S. Patent pending at this time.

ezURLPrefixFromHref(hRef)

The “ezURLPrefixFromHref(hRef)” function takes one argument that is typically the window.location.href value and returns all but the last List element as delimited by “/” characters.

ezFirstFolderAfterDomainNameFromHref(hRef)

The “ezFirstFolderAfterDomainNameFromHref(hRef)” function takes one argument that is typically the window.location.href value and returns the folder name that follows the domain name from the “hRef” argument. This function works best when the application is hosted in a folder that is not the webroot folder.

ezFilePath2HrefUsingCommonFolder(fPath, hRef, commonFolder)

The “ezFilePath2HrefUsingCommonFolder(fPath, hRef, commonFolder)” function takes three arguments which are the “fPath” or file path, the “hRef” or window.location.href and the “commonFolder” which is the name of the folder that is returned from the “firstFolderAfterDomainNameFromHref(hRef)” function. This function is useful when the goal is to deploy a web app in any folder that is not the webroot for a server that has several web apps hosted on it without the need to know about or care about which specific folder the web app has been deployed into.

ezGetStyle(el, style)

The “ezGetStyle(el, style)” function takes two arguments which are the “el” element object and the “style” name returning the value of the specific “style” from the “el” element.