diff -r 000000000000 -r 40c8f766c9b8 src/cm/media/js/lib/yui/yui3.0.0/api/Node.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/cm/media/js/lib/yui/yui3.0.0/api/Node.html Mon Nov 23 15:14:29 2009 +0100 @@ -0,0 +1,3645 @@ + + + + + API: node Node (YUI Library) + + + + + + + + + + +
+
+

Yahoo! UI Library

+

node  3.0.0

+ Yahoo! UI Library + > node + > Node + +
+
+ Search: +
+   +
+
+
+
+ +
+
+
+
+
+ Filters + + + +
+
+ +

+ + + + + Class Node + + + +

+ + + + + +
+ The Node class provides a wrapper for manipulating DOM Nodes. +Node properties can be accessed via the set/get methods. +Use Y.get() to retrieve Node instances. +NOTE: Node properties are accessed using +the set and get methods. +
+ +
+

Constructor

+
+
+ Node + + ( + ) + +
+ + +
+
+
+
+ +
+ +
+ +
+
+

Methods

+
+
+

+ addClass

+
+ + + + + void + addClass + ( + + + className + + + ) + + +
+ Adds a class name to each node. +
+ +
+ +
+
Parameters:
+
+ className + <String> + + the class name to add to the node's class attribute +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ all

+
+ + + + + NodeList + all + ( + + + selector + + + ) + + +
+ Retrieves a nodeList based on the given CSS selector. +
+ +
+ +
+
Parameters:
+
+ selector + <string> + + The CSS selector to test against. +
+
+ +
+
Returns: + + NodeList +
+
A NodeList instance for the matching HTMLCollection/Array.
+
+ + + + +
+ +
+
+
+
+

+ ancestor

+
+ + + + + Node + ancestor + ( + + + fn + + + ) + + +
+ Returns the nearest ancestor that passes the test applied by supplied boolean method. +
+ +
+ +
+
Parameters:
+
+ fn + <String | Function> + + A selector string or boolean method for testing elements. +If a function is used, it receives the current node being tested as the only argument. +
+
+ +
+
Returns: + + Node +
+
The matching Node instance or null if not found
+
+ + + + +
+ +
+
+
+
+

+ append

+
+ + + + + void + append + ( + + + content + + + ) + + +
+ Inserts the content as the lastChild of the node. +
+ +
+ +
+
Parameters:
+
+ content + <String | Y.Node | HTMLElement> + + The content to insert +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ appendChild

+
+ + + + + Node + appendChild + ( + + + node + + + ) + + +
+ Passes through to DOM method. +
+ +
+ +
+
Parameters:
+
+ node + <HTMLElement | Node> + + Node to be appended +
+
+ +
+
Returns: + + Node +
+
The appended node
+
+ + + + +
+ +
+
+
+
+

+ blur

+
+ + + + + void + blur + ( + ) + + +
+ Passes through to DOM method. +
+ +
+ + + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ cloneNode

+
+ + + + + Node + cloneNode + ( + + + deep + + + ) + + +
+ Passes through to DOM method. +
+ +
+ +
+
Parameters:
+
+ deep + <Boolean> + + Whether or not to perform a deep clone, which includes +subtree and attributes +
+
+ +
+
Returns: + + Node +
+
The clone
+
+ + + + +
+ +
+
+
+
+

+ compareTo

+
+ + + + + Boolean + compareTo + ( + + + refNode + + + ) + + +
+ Compares nodes to determine if they match. +Node instances can be compared to each other and/or HTMLElements. +
+ +
+ +
+
Parameters:
+
+ refNode + <HTMLElement | Node> + + The reference node to compare to the node. +
+
+ +
+
Returns: + + Boolean +
+
True if the nodes match, false if they do not.
+
+ + + + +
+ +
+
+
+
+

+ contains

+
+ + + + + Boolean + contains + ( + + + needle + + + ) + + +
+ Determines whether the ndoe is an ancestor of another HTML element in the DOM hierarchy. +
+ +
+ +
+
Parameters:
+
+ needle + <Node | HTMLElement> + + The possible node or descendent +
+
+ +
+
Returns: + + Boolean +
+
Whether or not this node is the needle its ancestor
+
+ + + + +
+ +
+
+
+
+

+ create

+
+ + + static + + Node + create + ( + + + html + + + , + doc + + + ) + + +
+ Creates a new dom node using the provided markup string. +
+ +
+ +
+
Parameters:
+
+ html + <String> + + The markup used to create the element +
+
+ doc + <HTMLDocument> + + An optional document context +
+
+ +
+
Returns: + + Node +
+
A Node instance bound to a DOM node or fragment
+
+ + + + +
+ +
+
+
+
+

+ delegate

+
+ + + + + Event.Handle + delegate + ( + + + type + + + , + fn + + + , + selector + + + ) + + +
+ Functionality to make the node a delegated event container +
+ +
+ +
+
Parameters:
+
+ type + <String> + + the event type to delegate +
+
+ fn + <Function> + + the function to execute +
+
+ selector + <String> + + a selector that must match the target of the event. +
+
+ +
+
Returns: + + Event.Handle +
+
the detach handle
+
+ + + + +
+ +
+
+
+
+

+ each

+
+ + + + + void + each + ( + + + fn + + + , + context + + + ) + + +
+ Applies the given function to each Node in the NodeList. +
+ +
+ +
+
Parameters:
+
+ fn + <Function> + + The function to apply +
+
+ context + <Object> + + optional An optional context to apply the function with +Default context is the NodeList instance +
+
+ + +
+ Chainable: This method is chainable. +
+ + +
+ Deprecated Use NodeList +
+ +
+ +
+
+
+
+

+ focus

+
+ + + + + void + focus + ( + ) + + +
+ Passes through to DOM method. +
+ +
+ + + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ get

+
+ + + + + any + get + ( + + + attr + + + ) + + +
+ Returns an attribute value on the Node instance +
+ +
+ +
+
Parameters:
+
+ attr + <String> + + The attribute to be set +
+
+ +
+
Returns: + + any +
+
The current value of the attribute
+
+ + + + +
+ +
+
+
+
+

+ getAttribute

+
+ + + + + string + getAttribute + ( + + + name + + + ) + + +
+ Allows getting attributes on DOM nodes, normalizing in some cases. +This passes through to the DOM node, allowing for custom attributes. +
+ +
+ +
+
Parameters:
+
+ name + <string> + + The attribute name +
+
+ +
+
Returns: + + string +
+
The attribute value
+
+ + + + +
+ +
+
+
+
+

+ getAttrs

+
+ + + + + Object + getAttrs + ( + + + attrs + + + ) + + +
+ Returns an object containing the values for the requested attributes. +
+ +
+ +
+
Parameters:
+
+ attrs + <Array> + + an array of attributes to get values +
+
+ +
+
Returns: + + Object +
+
An object with attribute name/value pairs.
+
+ + + + +
+ +
+
+
+
+

+ getComputedStyle

+
+ + + + + String + getComputedStyle + ( + + + attr + + + ) + + +
+ Returns the computed value for the given style property. +
+ +
+ +
+
Parameters:
+
+ attr + <String> + + The style attribute to retrieve. +
+
+ +
+
Returns: + + String +
+
The computed value of the style property for the element.
+
+ + + + +
+ +
+
+
+
+

+ getElementsByTagName

+
+ + + + + NodeList + getElementsByTagName + ( + + + tagName + + + ) + + +
+ Passes through to DOM method. +
+ +
+ +
+
Parameters:
+
+ tagName + <String> + + The tagName to collect +
+
+ +
+
Returns: + + NodeList +
+
A NodeList representing the HTMLCollection
+
+ + + + +
+ +
+
+
+
+

+ getStyle

+
+ + + + + String + getStyle + ( + + + attr + + + ) + + +
+ Returns the style's current value. +
+ +
+ +
+
Parameters:
+
+ attr + <String> + + The style attribute to retrieve. +
+
+ +
+
Returns: + + String +
+
The current value of the style property for the element.
+
+ + + + +
+ +
+
+
+
+

+ getX

+
+ + + + + Int + getX + ( + ) + + +
+ Gets the current position of the node in page coordinates. +
+ +
+ + +
+
Returns: + + Int +
+
The X position of the node
+
+ + + + +
+ +
+
+
+
+

+ getXY

+
+ + + + + Array + getXY + ( + ) + + +
+ Gets the current position of the node in page coordinates. +
+ +
+ + +
+
Returns: + + Array +
+
The XY position of the node
+
+ + + + +
+ +
+
+
+
+

+ getY

+
+ + + + + Int + getY + ( + ) + + +
+ Gets the current position of the node in page coordinates. +
+ +
+ + +
+
Returns: + + Int +
+
The Y position of the node
+
+ + + + +
+ +
+
+
+
+

+ hasAttribute

+
+ + + + + Boolean + hasAttribute + ( + + + attribute + + + ) + + +
+ Passes through to DOM method. +
+ +
+ +
+
Parameters:
+
+ attribute + <String> + + The attribute to test for +
+
+ +
+
Returns: + + Boolean +
+
Whether or not the attribute is present
+
+ + + + +
+ +
+
+
+
+

+ hasChildNodes

+
+ + + + + Boolean + hasChildNodes + ( + ) + + +
+ Passes through to DOM method. +
+ +
+ + +
+
Returns: + + Boolean +
+
Whether or not the node has any childNodes
+
+ + + + +
+ +
+
+
+
+

+ hasClass

+
+ + + + + Array + hasClass + ( + + + className + + + ) + + +
+ Determines whether each node has the given className. +
+ +
+ +
+
Parameters:
+
+ className + <String> + + the class name to search for +
+
+ +
+
Returns: + + Array +
+
An array of booleans for each node bound to the NodeList.
+
+ + + + +
+ +
+
+
+
+

+ inDoc

+
+ + + + + Boolean + inDoc + ( + + + doc + + + ) + + +
+ Determines whether the node is appended to the document. +
+ +
+ +
+
Parameters:
+
+ doc + <Node|HTMLElement> + + optional An optional document to check against. +Defaults to current document. +
+
+ +
+
Returns: + + Boolean +
+
Whether or not this node is appended to the document.
+
+ + + + +
+ +
+
+
+
+

+ inRegion

+
+ + + + + Object + inRegion + ( + + + node2 + + + , + all + + + , + altRegion + + + ) + + +
+ Determines whether or not the node is within the giving region. +
+ +
+ +
+
Parameters:
+
+ node2 + <Node|Object> + + The node or region to compare with. +
+
+ all + <Boolean> + + Whether or not all of the node must be in the region. +
+
+ altRegion + <Object> + + An alternate region to use (rather than this node's). +
+
+ +
+
Returns: + + Object +
+
An object representing the intersection of the regions.
+
+ + + + +
+ +
+
+
+
+

+ insert

+
+ + + + + void + insert + ( + + + content + + + , + where + + + ) + + +
+ Inserts the content before the reference node. +
+ +
+ +
+
Parameters:
+
+ content + <String | Y.Node | HTMLElement> + + The content to insert +
+
+ where + <Int | Y.Node | HTMLElement | String> + + The position to insert at. +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ insertBefore

+
+ + + + + Node + insertBefore + ( + + + newNode + + + , + refNode + + + ) + + +
+ Passes through to DOM method. +
+ +
+ +
+
Parameters:
+
+ newNode + <HTMLElement | Node> + + Node to be appended +
+
+ refNode + <HTMLElement | Node> + + Node to be inserted before +
+
+ +
+
Returns: + + Node +
+
The inserted node
+
+ + + + +
+ +
+
+
+
+

+ intersect

+
+ + + + + Object + intersect + ( + + + node2 + + + , + altRegion + + + ) + + +
+ Compares the intersection of the node with another node or region +
+ +
+ +
+
Parameters:
+
+ node2 + <Node|Object> + + The node or region to compare with. +
+
+ altRegion + <Object> + + An alternate region to use (rather than this node's). +
+
+ +
+
Returns: + + Object +
+
An object representing the intersection of the regions.
+
+ + + + +
+ +
+
+
+
+

+ invoke

+
+ + + + + + invoke + ( + + + method + + + , + a, + + + ) + + +
+ Invokes a method on the Node instance +
+ +
+ +
+
Parameters:
+
+ method + <String> + + The name of the method to invoke +
+
+ a, + <Any> + + b, c, etc. Arguments to invoke the method with. +
+
+ +
+
Returns: + +
+
Whatever the underly method returns. +DOM Nodes and Collections return values +are converted to Node/NodeList instances.
+
+ + + + +
+ +
+
+
+
+

+ item

+
+ + + + + Node + item + ( + + + index + + + ) + + +
+ Retrieves the Node instance at the given index. +
+ +
+ +
+
Parameters:
+
+ index + <Number> + + The index of the target Node. +
+
+ +
+
Returns: + + Node +
+
The Node instance at the given index.
+
+ + + +
+ Deprecated Use NodeList +
+ +
+ +
+
+
+
+

+ next

+
+ + + + + Node + next + ( + + + fn + + + ) + + +
+ Returns the next matching sibling. +Returns the nearest element node sibling if no method provided. +
+ +
+ +
+
Parameters:
+
+ fn + <String | Function> + + A selector or boolean method for testing elements. +If a function is used, it receives the current node being tested as the only argument. +
+
+ +
+
Returns: + + Node +
+
Node instance or null if not found
+
+ + + + +
+ +
+
+
+
+

+ Node.getDOMNode

+
+ + + static + + HTMLNode + Node.getDOMNode + ( + + + node + + + ) + + +
+ Retrieves the DOM node bound to a Node instance +
+ +
+ +
+
Parameters:
+
+ node + <Y.Node || HTMLNode> + + The Node instance or an HTMLNode +
+
+ +
+
Returns: + + HTMLNode +
+
The DOM node bound to the Node instance. If a DOM node is passed +as the node argument, it is simply returned.
+
+ + + + +
+ +
+
+
+
+

+ one

+
+ + + + + Node + one + ( + + + selector + + + ) + + +
+ Retrieves a Node instance of nodes based on the given CSS selector. +
+ +
+ +
+
Parameters:
+
+ selector + <string> + + The CSS selector to test against. +
+
+ +
+
Returns: + + Node +
+
A Node instance for the matching HTMLElement.
+
+ + + + +
+ +
+
+
+
+

+ prepend

+
+ + + + + void + prepend + ( + + + content + + + ) + + +
+ Inserts the content as the firstChild of the node. +
+ +
+ +
+
Parameters:
+
+ content + <String | Y.Node | HTMLElement> + + The content to insert +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ previous

+
+ + + + + Node + previous + ( + + + fn + + + ) + + +
+ Returns the previous matching sibling. +Returns the nearest element node sibling if no method provided. +
+ +
+ +
+
Parameters:
+
+ fn + <String | Function> + + A selector or boolean method for testing elements. +If a function is used, it receives the current node being tested as the only argument. +
+
+ +
+
Returns: + + Node +
+
Node instance or null if not found
+
+ + + + +
+ +
+
+
+
+

+ query

+
+ + + + + Node + query + ( + + + selector + + + ) + + +
+ Retrieves a Node instance of nodes based on the given CSS selector. +
+ +
+ +
+
Parameters:
+
+ selector + <string> + + The CSS selector to test against. +
+
+ +
+
Returns: + + Node +
+
A Node instance for the matching HTMLElement.
+
+ + + +
+ Deprecated Use one() +
+ +
+ +
+
+
+
+

+ queryAll

+
+ + + + + NodeList + queryAll + ( + + + selector + + + ) + + +
+ Retrieves a nodeList based on the given CSS selector. +
+ +
+ +
+
Parameters:
+
+ selector + <string> + + The CSS selector to test against. +
+
+ +
+
Returns: + + NodeList +
+
A NodeList instance for the matching HTMLCollection/Array.
+
+ + + +
+ Deprecated Use all() +
+ +
+ +
+
+
+
+

+ remove

+
+ + + + + void + remove + ( + ) + + +
+ Removes the node from its parent. +Shortcut for myNode.get('parentNode').removeChild(myNode); +
+ +
+ + + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ removeAttribute

+
+ + + + + void + removeAttribute + ( + + + attribute + + + ) + + +
+ Passes through to DOM method. +
+ +
+ +
+
Parameters:
+
+ attribute + <String> + + The attribute to be removed +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ removeChild

+
+ + + + + Node + removeChild + ( + + + node + + + ) + + +
+ Passes through to DOM method. +
+ +
+ +
+
Parameters:
+
+ node + <HTMLElement | Node> + + Node to be removed +
+
+ +
+
Returns: + + Node +
+
The removed node
+
+ + + + +
+ +
+
+
+
+

+ removeClass

+
+ + + + + void + removeClass + ( + + + className + + + ) + + +
+ Removes a class name from each node. +
+ +
+ +
+
Parameters:
+
+ className + <String> + + the class name to remove from the node's class attribute +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ replace

+
+ + + + + void + replace + ( + ) + + +
+ Replace the node with the other node. This is a DOM update only +and does not change the node bound to the Node instance. +Shortcut for myNode.get('parentNode').replaceChild(newNode, myNode); +
+ +
+ + + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ replaceChild

+
+ + + + + Node + replaceChild + ( + + + node + + + , + refNode + + + ) + + +
+ Passes through to DOM method. +
+ +
+ +
+
Parameters:
+
+ node + <HTMLElement | Node> + + Node to be inserted +
+
+ refNode + <HTMLElement | Node> + + Node to be replaced +
+
+ +
+
Returns: + + Node +
+
The replaced node
+
+ + + + +
+ +
+
+
+
+

+ replaceClass

+
+ + + + + void + replaceClass + ( + + + oldClassName + + + , + newClassName + + + ) + + +
+ Replace a class with another class for each node. +If no oldClassName is present, the newClassName is simply added. +
+ +
+ +
+
Parameters:
+
+ oldClassName + <String> + + the class name to be replaced +
+
+ newClassName + <String> + + the class name that will be replacing the old class name +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ reset

+
+ + + + + void + reset + ( + ) + + +
+ Passes through to DOM method. +Only valid on FORM elements +
+ +
+ + + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ scrollIntoView

+
+ + + + + void + scrollIntoView + ( + ) + + +
+ Passes through to DOM method. +
+ +
+ + + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ select

+
+ + + + + void + select + ( + ) + + +
+ Passes through to DOM method. +
+ +
+ + + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ set

+
+ + + + + void + set + ( + + + attr + + + , + val + + + ) + + +
+ Sets an attribute on the Node instance. +
+ +
+ +
+
Parameters:
+
+ attr + <String> + + The attribute to be set. +
+
+ val + <any> + + The value to set the attribute to. +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ setAttribute

+
+ + + + + void + setAttribute + ( + + + name + + + , + value + + + ) + + +
+ Allows setting attributes on DOM nodes, normalizing in some cases. +This passes through to the DOM node, allowing for custom attributes. +
+ +
+ +
+
Parameters:
+
+ name + <string> + + The attribute name +
+
+ value + <string> + + The value to set +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ setAttrs

+
+ + + + + void + setAttrs + ( + + + attrMap + + + ) + + +
+ Sets multiple attributes. +
+ +
+ +
+
Parameters:
+
+ attrMap + <Object> + + an object of name/value pairs to set +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ setContent

+
+ + + + + void + setContent + ( + + + content + + + ) + + +
+ Replaces the node's current content with the content. +
+ +
+ +
+
Parameters:
+
+ content + <String | Y.Node | HTMLElement> + + The content to insert +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ setStyle

+
+ + + + + void + setStyle + ( + + + attr + + + , + val + + + ) + + +
+ Sets a style property of the node. +
+ +
+ +
+
Parameters:
+
+ attr + <String> + + The style attribute to set. +
+
+ val + <String|Number> + + The value. +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ setStyles

+
+ + + + + void + setStyles + ( + + + hash + + + ) + + +
+ Sets multiple style properties on the node. +
+ +
+ +
+
Parameters:
+
+ hash + <Object> + + An object literal of property:value pairs. +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ setX

+
+ + + + + void + setX + ( + + + x + + + ) + + +
+ Set the position of the node in page coordinates, regardless of how the node is positioned. +
+ +
+ +
+
Parameters:
+
+ x + <Int> + + X value for new position (coordinates are page-based) +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ setXY

+
+ + + + + void + setXY + ( + + + xy + + + ) + + +
+ Set the position of the node in page coordinates, regardless of how the node is positioned. +
+ +
+ +
+
Parameters:
+
+ xy + <Array> + + Contains X & Y values for new position (coordinates are page-based) +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ setY

+
+ + + + + void + setY + ( + + + y + + + ) + + +
+ Set the position of the node in page coordinates, regardless of how the node is positioned. +
+ +
+ +
+
Parameters:
+
+ y + <Int> + + Y value for new position (coordinates are page-based) +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ simulate

+
+ + + static + + void + simulate + ( + + + type + + + , + options + + + ) + + +
+ Simulates an event on the node. +
+ +
+ +
+
Parameters:
+
+ type + <String> + + The type of event to simulate (i.e., "click"). +
+
+ options + <Object> + + (Optional) Extra options to copy onto the event object. +
+
+ + + + + +
+ +
+
+
+
+

+ size

+
+ + + + + Int + size + ( + ) + + +
+ Returns the current number of items in the Node. +
+ +
+ + +
+
Returns: + + Int +
+
The number of items in the Node.
+
+ + + +
+ Deprecated Use NodeList +
+ +
+ +
+
+
+
+

+ submit

+
+ + + + + void + submit + ( + ) + + +
+ Passes through to DOM method. +Only valid on FORM elements +
+ +
+ + + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ test

+
+ + + + + boolean + test + ( + + + selector + + + ) + + +
+ Test if the supplied node matches the supplied selector. +
+ +
+ +
+
Parameters:
+
+ selector + <string> + + The CSS selector to test against. +
+
+ +
+
Returns: + + boolean +
+
Whether or not the node matches the selector.
+
+ + + + +
+ +
+
+
+
+

+ toggleClass

+
+ + + + + void + toggleClass + ( + + + className + + + ) + + +
+ If the className exists on the node it is removed, if it doesn't exist it is added. +
+ +
+ +
+
Parameters:
+
+ className + <String> + + the class name to be toggled +
+
+ + +
+ Chainable: This method is chainable. +
+ + + +
+ +
+
+
+
+

+ Y.get

+
+ + + static + + void + Y.get + ( + + + node + + + , + doc + + + ) + + +
+ Returns a single Node instance bound to the node or the +first element matching the given selector. +
+ +
+ +
+
Parameters:
+
+ node + <String | HTMLElement> + + a node or Selector +
+
+ doc + <Y.Node || HTMLElement> + + an optional document to scan. Defaults to Y.config.doc. +
+
+ + + + +
+ Deprecated Use Y.one +
+ +
+ +
+
+
+
+

+ Y.one

+
+ + + static + + void + Y.one + ( + + + node + + + , + doc + + + ) + + +
+ Returns a single Node instance bound to the node or the +first element matching the given selector. +
+ +
+ +
+
Parameters:
+
+ node + <String | HTMLElement> + + a node or Selector +
+
+ doc + <Y.Node || HTMLElement> + + an optional document to scan. Defaults to Y.config.doc. +
+
+ + + + + +
+ +
+
+
+
+
+ +
+ +
+ + +
+ +
+
+

Configuration Attributes

+
+
+

children + - NodeList +

+
+
+ Returns a NodeList instance of all HTMLElement children. +
+
+ + + +
+
+
+

docHeight + - {Int} +

+
+
+ Document height +
+
+ + + +
+
+
+

docScrollX + - {Int} +

+
+
+ Amount page has been scroll vertically +
+
+ + + +
+
+
+

docScrollY + - {Int} +

+
+
+ Amount page has been scroll horizontally +
+
+ + + +
+
+
+

region + - Node +

+
+
+ Returns a region object for the node +
+
+ + + +
+
+
+

text + - String +

+
+
+ Allows for getting and setting the text of an element. +Formatting is preserved and special characters are treated literally. +
+
+ + + +
+
+
+

viewportRegion + - Node +

+
+
+ Returns a region object for the node's viewport +
+
+ + + +
+
+
+

winHeight + - {Int} +

+
+
+ Returns the inner height of the viewport (exludes scrollbar). +
+
+ + + +
+
+
+

winWidth + - {Int} +

+
+
+ Returns the inner width of the viewport (exludes scrollbar). +
+
+ + + +
+
+ +
+
+ +
+ +
+
+
+ +
+
+
+
+ Copyright © 2009 Yahoo! Inc. All rights reserved. +
+
+ + +