[转载]YUI中文Dom操作(三)

YAHOO.util.Dom.getRegion( node )

返回指定元素的区域位置。该元素必须存在于 DOM 树中以拥有区域（display:none 或没有添加到DOM中的元素返回 false）。
Parameters:
el <String | HTMLElement | Array> 接受一个会将其当作ID来获取DOM引用的字符串，或者一个真实的DOM引用，或者一个包含ID及/或引用的数组。
Returns: Region | Array
一个或一组包含"top, left, bottom, right"成员数据的 Region 对象实例。

演示实例：http://www.css88.com/YUI/DOM/getRegion.html
转载请注明出处：http://www.css88.com 或http://www.9demo.com

============================================================

YAHOO.util.Dom.getStyle ( el , property )

String | Array getStyle ( el , property )
标准化 currentStyle 和 ComputedStyle.
Parameters:
el <String | HTMLElement |Array> 接受一个会将其当作ID来获取DOM引用的字符串，或者一个真实的DOM引用，或者一个包含ID及/或引用的数组。
property <String> 要获取的样式属性名
Returns: String | Array
该（组）元素的指定样式属性的当前值。

YAHOO.util.Dom.getRegion.setStyle ( el , property , val )
void setStyle ( el , property , val )
封装对 HTMLElement 的 style 属性的设置。标准化跨浏览器的 "opacity" 样式。
Parameters:
el <String | HTMLElement | Array> 接受一个会将其当作ID来获取DOM引用的字符串，或者一个真实的DOM引用，或者一个包含ID及/或引用的数组。
property <String> 要设置的 style 属性
val <String> 应用到该 style 属性的值
Returns: void

演示实例：http://www.css88.com/YUI/DOM/getStyle&setStyle.html
转载请注明出处：http://www.css88.com 或http://www.9demo.com

============================================================

YAHOO.util.Dom.getViewportWidth()和YAHOO.util.Dom.getViewportHeight()

返回窗口当前的可视宽度/高度。
Returns: Int
页面可视区域的宽度/高度 （不包括滚动条）。

注意：如果您改变窗口大小，这两个值会发生变换，注意“可视”

演示实例：http://www.css88.com/YUI/DOM/getViewportWidth&getViewportHeight.html
转载请注明出处：http://www.css88.com 或http://www.9demo.com

============================================================

YAHOO.util.Dom.getX( el )

Number | Array getX ( el )
基于页面坐标获取一个元素当前的 X 坐标位置。该元素必须存在于 DOM 树中以拥有页面坐标（display:none 或没有添加到DOM中的元素返回 false）。
Parameters:
el <String | HTMLElement | Array> 接受一个会将其当作ID来获取DOM引用的字符串，或者一个真实的DOM引用，或者一个包含ID及/或引用的数组。
Returns: Number | Array
该（组） 元素的 X 坐标位置

--------------------------------------------------------------------------------

YAHOO.util.Dom.getXY ( el )
基于页面坐标获取一个元素当前坐标位置。该元素必须存在于 DOM 树中以拥有页面坐标（display:none 或没有添加到DOM中的元素返回 false）。
Parameters:
el <String | HTMLElement | Array> 接受一个会将其当作ID来获取DOM引用的字符串，或者一个真实的DOM引用，或者一个包含ID及/或引用的数组。
Returns: Array
该（组） 元素的坐标位置

--------------------------------------------------------------------------------

YAHOO.util.Dom getY ( el )
基于页面坐标获取一个元素当前的 X 坐标位置。该元素必须存在于 DOM 树中以拥有页面坐标（display:none 或没有添加到DOM中的元素返回 false）。
Parameters:
el <String | HTMLElement | Array> 接受一个会将其当作ID来获取DOM引用的字符串，或者一个真实的DOM引用，或者一个包含ID及/或引用的数组。
Returns: Number | Array
该（组） 元素的 X 坐标位置

===========================================
YAHOO.util.Dom.setX ( el , x )
设置一个（组） html 元素在页面坐标中的 X 位置，不管该元素的 position 样式控制。该元素必须存在于 DOM 树中以拥有页面坐标（display:none 或没有添加到DOM中的元素返回 false）。
Parameters:
el <String | HTMLElement | Array> 接受一个会将其当作ID来获取DOM引用的字符串，或者一个真实的DOM引用，或者一个包含ID及/或引用的数组。
x <Int> 设置给该（组）元素的的 X 坐标
Returns: void

--------------------------------------------------------------------------------

YAHOO.util.Dom. setXY ( el , pos , noRetry )
设置一个（组） html 元素在页面坐标中的 X 位置，不管该元素的 position 样式控制。该元素必须存在于 DOM 树中以拥有页面坐标（display:none 或没有添加到DOM中的元素返回 false）。
Parameters:
el <String | HTMLElement | Array> 接受一个会将其当作ID来获取DOM引用的字符串，或者一个真实的DOM引用，或者一个包含ID及/或引用的数组。
pos <Array> 包含新的X & Y坐标（基于页面坐标）
noRetry <Boolean> 缺省情况下，如果第一次设置坐标失败，我们尝试第二次设置。
Returns: void

--------------------------------------------------------------------------------

YAHOO.util.Dom.setY ( el , x )
设置一个（组） html 元素在页面坐标中的 Y 位置，不管该元素的 position 样式控制。该元素必须存在于 DOM 树中以拥有页面坐标（display:none 或没有添加到DOM中的元素返回 false）。
Parameters:
el <String | HTMLElement | Array> 接受一个会将其当作ID来获取DOM引用的字符串，或者一个真实的DOM引用，或者一个包含ID及/或引用的数组。
x <Int> 设置给该（组）元素的的 X 坐标
Returns: void  

演示实例：http://www.css88.com/YUI/DOM/getXY&setXY.html
转载请注明出处：http://www.css88.com 或http://www.9demo.com

============================================================

YAHOO.util.Dom.removeClass( el , className )

移除给定的一个或一组元素的某个 class 。
Parameters:
el <String | HTMLElement | Array> 要移除其 class 的一个或一组元素
className <String> 要从 class 属性中移除的 class
Returns: Boolean | Array
移除成功返回 true，反之返回 false，或者一个包含这样的布尔值的数组

YAHOO.util.Dom.replaceClass( el , oldClassName , newClassName)

替换给定的一个或一组元素的某个 class 。如果旧 class 不存在，则简单的添加新的 class 。 If no oldClassName is present, the newClassName is simply added.
Parameters:
el <String | HTMLElement | Array> 要替换其 class 的一个或一组元素
oldClassName <String> 将被替换的旧 class
newClassName <String> 将替换旧 class 的 新 class
Returns: Boolean | Array
替换成功返回 true，反之返回 false，或者一个包含这样的布尔值的数组

YAHOO.util.Dom.hasClass( el , className )

判定一个 HTMLElement 是否拥有给定的 className.
Parameters:
el <String | HTMLElement | Array> 要检测的一个或一组元素
className <String> 要检索的 className
Returns: Boolean | Array
如果拥有返回 true，反之返回 false，或者一个包含这样的布尔值的数组

演示实例：http://www.css88.com/YUI/DOM/hasClass.html
转载请注明出处：http://www.css88.com 或http://www.9demo.com

============================================================================

YAHOO.util.Dom. inDocument ( el )
判定一个 HTMLElement 是否在当前文档中存在。
Parameters:
el <String | HTMLElement> 要搜索的元素
Returns: Boolean
如果存在于当前文档返回 true，反之 false

--------------------------------------------------------------------------------
YAHOO.util.Dom. isAncestor ( haystack , needle )
判定一个 HTMLElement 在DOM中是否是另一个 HTML 元素的祖先节点。
Parameters:
haystack <String | HTMLElement> 可能的祖先节点
needle <String | HTMLElement> 可能的后代节点
Returns: Boolean
如果前者是后者的祖先节点返回 true，反之 false

演示实例：http://www.css88.com/YUI/DOM/inDocument.html
转载请注明出处：http://www.css88.com 或http://www.9demo.com

==================================================================

YAHOO.util.Dom. insertAfter ( newNode , referenceNode )
将新节点插入到参考节点之后，成为其下一个兄弟节点。
Parameters:
newNode <String | HTMLElement> 要被插入的节点
referenceNode <String | HTMLElement> 在其后插入新节点的参考节点
Returns: HTMLElement
返回被插入的节点（或插入失败时返回 null）

--------------------------------------------------------------------------------

YAHOO.util.Dom. insertBefore ( newNode , referenceNode )
将新节点插入到参考节点之前，成为其上一个兄弟节点。
Parameters:
newNode <String | HTMLElement> 要被插入的节点
referenceNode <String | HTMLElement> 在其之前插入新节点的参考节点
Returns: HTMLElement
返回被插入的节点（或插入失败时返回 null）