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.

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, includingThis)

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.
includingThis - Flag denoting that the object seach starts from this node instead of the parentNode

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.

getIValue

String getIValue(node)

Returns the value of the "mo:value" attribute safely.

Parameters:
node - The node to extract the "mo:value" attribute from

getMoChild

HTMLElement getMoChild(parentNode, type, name)

Returns the first child node that has the specified mo:type and optionally mo:name.

Parameters:
parentNode - The HTML node whose children will be searched
type - The mo:type to find.
name - The mo:name or the name of the node.

getMoName

String getMoName(node)

Returns the value of the "mo:name" attribute safely. If "mo:name" attribute is missing then the value of "name" attribute is returned.

Parameters:
node - The node to extract the attribute value from

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

getMoObject

HTMLElement getMoObject(parentNode, type, name)

Searches the first child node that has the specified mo:type and mo:name and returns the MoreMotionObject that wraps it.

Parameters:
parentNode - The HTML node whose children will be searched
type - The mo:type to find.
name - The mo:name or the name of the node.

getMoParent

HTMLElement getMoParent(node, type, name, depth)

Returns the first parent node that has the specified type and optionally name.

Parameters:
node - The HTML node whose parents will be searched
type - The mo:type to find.
name - The mo:name or the name of the node. Optional.
depth - The search depth

getNodeByClass

HTMLElement getNodeByClass(parentNode, className)

Returns the first child node that has the specified class name

Parameters:
parentNode - The HTML node whose children will be searched
className - The className to find.

getObject

ProcessField 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

ProcessField 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

String 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.

needsInit

Object needsInit(node)

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)

Disables of enables all the input elements existing in the given DOM node

Parameters:
node - The container DOM node whose children to be enabled or disabled
value - boolean param. It should be true to disable false to enable

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

setIValue

void setIValue(node, value)

Sets the value of the "mo:value" attribute safely. Provided to solve the unpredictable errors of IE.

Parameters:
node - The node whose "mo:value" attribute to set
value - The value of the attribute

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