Class MoreMotionObjectManager

Object
   |
   +--MoreMotionObjectManager

class MoreMotionObjectManager

Manager Class that provides methods to navigate through the DOM structure and manage MoreMotionObject objects. A static object of this class is available with name OMgr.

var OMgr = new MoreMotionObjectManager();

Constructor Detail

MoreMotionObjectManager

MoreMotionObjectManager()

addToCache

void addToCache(key, object, area)

Adds the given object to the cache with the specified key

Parameters:
key - The key for the cache
object - The object to store in the cache
area - The area that the given object resides in

attachEvent

void attachEvent(node,name,func)

Cross browser event attacher

Parameters:
node - The DOM Node to attach the event
name - The name of the event without "on". e.g. "mousemove" not "onmousemove".
func - function to attach

createElement

Object createElement(tagName, elmName)

detachEvent

void detachEvent(node,name,func)

Cross browser event detacher

Parameters:
node - The DOM node to detach the event
name - The name of the event without "on". e.g. "mousemove" not "onmousemove".
func - function to detach

findChildNode

HTMLElement findChildNode(parentNode, nodeName, attrName, attrValue, depth)

Searches the specified HTML Node under the given node.

Parameters:
parentNode - The HTML node whose children will be searched
nodeName - The name of the node to focus the search. If specified the search will be performed only on the nodes that has this name.
attrName - The name of the attribute to find a matching value
attrValue - The value to match in the attribute value. If this parameter is omitted or is null then the analyzed node is selected in case of it has the attribute with the given name regardless of its value.
depth - The depth of the search. If omitted 999 is assumed.

findChildObject

MoreMotionObject findChildObject(parentNode, nodeName, attrName, attrValue, depth)

Searches the specified HTML Node under the given node and returns the MoreMotionObject that wraps it.

Parameters:
parentNode - The HTML node whose children will be searched
nodeName - The name of the node to focus the search. If specified the search will be performed only on the nodes that has this name.
attrName - The name of the attribute to find a matching value
attrValue - The value to match in the attribute value. If this parameter is omitted or is null then the analyzed node is selected in case of it has the attribute with the given name regardless of its value.
depth - The depth of the search. If omitted 999 is assumed.

findParentNode

HTMLElement findParentNode(node,attrName,attrValue)

Returns the first parent node that has the specified attribute and attribute value.

Parameters:
node - The HTML node whose parent will be searched
attrName - The name of the attribute to find a matching value
attrValue - The value to match in the attribute value. If this parameter is omitted or is null then the analyzed node is selected in case of it has the attribute with the given name regardless of its value.

findParentObject

MoreMotionObject findParentObject(node,attrName,attrValue)

Locates the first parent node that has the specified attribute and attribute value and returns the MoreMotionObject that wraps it.

Parameters:
node - The HTML node whose parent will be searched
attrName - The name of the attribute to find a matching value
attrValue - The value to match in the attribute value. If this parameter is omitted or is null then the analyzed node is selected in case of it has the attribute with the given name regardless of its value.

getAttribute

String getAttribute(node,attrName)

Returns the value of the given attribute safely. Provided to solve the unpredictable errors of IE.

Parameters:
node - The node to extract the attribute value from
attrName - The name of the attribute

Returns:
The value of the attribute

getChildInputElements

HTMLElement[] getChildInputElements(node)

Returns an array of all form elements ("input", "button", "select" and "editarea") that exits under the given node.

Returns:
An array of DOM elements

getChildNode

HTMLElement getChildNode(parentNode, nodeName, elmName)

Returns the first child node with the given node name.

Parameters:
parentNode - The HTML node whose children will be searched
nodeName - The name of the node to find.
elmName - The element name. It is optional.

getEnclosingObject

MoreMotionObject getEnclosingObject(node)

Searches the parent nodes of the given DOM element node to find a MoreMotionObject node. If it finds then it creates an instance of it and returns it.

Parameters:
node - The DOM element node to start searching the parent nodes.

getFromCache

Object getFromCache(key)

Returns the object associated with the given key from the cache. Returns null if no object is found.

Parameters:
key - The key for the cache.

getMoNodes

HTMLNode[] getMoNodes(parentNode, types)

Searches the child nodes of the given node and returns an array nodes that have the specified mo:type

Parameters:
parentNode - The HTML node whose children will be searched
types - A single string or a string array that defines the type or types to collect

Returns:
An array of MoreMotion Objects

getObject

Object getObject(node)

Creates the MoreMotionObject defined in the "mo:type" attribute of the given DOM element node and returns it.

Parameters:
node - The DOM element node that contains "mo:type" attribute.

getObjectById

Object getObjectById(id)

Creates the MoreMotionObject defined in the "mo:type" attribute of the DOM element whose id is given and returns it.

Parameters:
id - The id of the element node that contains "mo:type" attribute.

getObjects

MoreMotionObject[] getObjects(parentNode, types, oldparam)

Searches the child nodes of the given node and returns an array of MoreMotion Objects that have the specified mo:type

Parameters:
parentNode - The HTML node whose children will be searched
types - A single string or a string array that defines the type or the types to collect

Returns:
An array of MoreMotion Objects

getPageInfo

PageInfo getPageInfo(node)

Searches the parents of the given node to find a node that has "mo:pageInfo" attribute to extract extracts and return the page info from there.

Parameters:
node - The DOM element node to start the searching off. If it is null then page info is taken from document.body node.

getParentNode

HTMLElement getParentNode(node, nodeName)

Returns the first parent node with the given node name.

Parameters:
node - The HTML node whose parent will be searched
nodeName - The name of the node to find.

getProps

props getProps(node)

Creates a props object from the value of the "mo:props" attribute of the given node and returns it.

Parameters:
node - The DOM element node

getStyle

Object getStyle(node, style)

Returns the computed style of the given node and the style name

Parameters:
node - The DOM node to investigate
style - The name of the CSS style in dashed form i.e. "text-align"

Returns:
the computed style

getUniqueId

Object getUniqueId(prefix)

Returns a unique id

Parameters:
prefix - A prefix for the id. If not specified "x" is assumed.

initialize

void initialize(node)

Initializes all the MoreMotionObject objects existing in the given DOM element node.

Parameters:
node - The DOM element node to start with initializing. If it is omitted document.body is used.

refreshAction

void refreshAction(frm)

Refreshes the value of the "_rand" hidden input element in the given form

Parameters:
frm - The Form object

refreshHref

void refreshHref(node)

Refreshes the value of the "_rand=" parameter existing in the href attribute of the specified DOM Node.

Parameters:
node - The DOM Node that has a href attribute. The value of the href attribute must have a "_rand=" definition.

refreshLink

Object refreshLink(href)

Refreshes the value of the "_rand=" parameter existing in the givn string and returns it.

Parameters:
href - The string that contains a "_rand=" definition

releaseCache

void releaseCache(area)

Releases all the object from the cache that reside in the given area

Parameters:
area - The name of the area to clear

removeFromCache

void removeFromCache(key)

Removes the object assocşated with the given key from the cache

Parameters:
key - The key for the cache

resetForm

void resetForm(nodeOrFormName)

Resets the specified form

Parameters:
nodeOrFormName - Either a DOM node existing in the form or the name of the form to submit

resource

Object resource(resId, parm1, parm2, parm3)

Returns the resource text associated with the specified resId. The %0, %1, %2 symbols in the resource text are replaces with the values of parm1, parm2 and parm3 parameters.

Parameters:
resId - the Resource id
parm1 - Resource parameter 1. (Optional)
parm2 - Resource parameter 2. (Optional)
parm3 - Resource parameter 3. (Optional)

setAttribute

void setAttribute(node, attrName, attrValue)

Sets the value of the given attribute safely. Provided to solve the unpredictable errors of IE.

Parameters:
node - The node to set the attribute value
attrName - The name of the attribute
attrValue - The value of the attribute

setDisabled

void setDisabled(node, value)

setInitialOption

void setInitialOption(elm, value)

Sets the initial value of the given SELECT element

Parameters:
elm - The handle or the id of a HTML SELECT element
value - The initial value

setOpacity

void setOpacity(node,ratio)

Cross browser opacity setter

Parameters:
node - The DOM node to set the opacity
ratio - the opacity ratio between 0 and 100

submitForm

void submitForm(nodeOrFormName, action)

Submits the specified form with the given action.

Parameters:
nodeOrFormName - Either a DOM node existing in the form or the name of the form to submit
action - The action to set to the from object before submit