element.dimensions.md.svn-base

mooltools源码很不错的源码

Native: Element {#Element}
==========================
与Element的尺寸和位置相关的方法

### 备注:

这些方法计算的时候不将body元素的margin和border计算在内.

如果你需要将其计算在内,请尝试采用在页面中添加一个div作为所有元素的容器, 并且将页面body的margin和border设置为0.

### Credits:

- 元素定位基于[qooxdoo](http://qooxdoo.org/)的计算和浏览器修补代码,[LGPL License](http://www.gnu.org/licenses/lgpl.html).
- Viewport(可视区)的尺寸计算基于[YUI](http://developer.yahoo.com/yui/)的代码, [BSD License](http://developer.yahoo.com/yui/license.html).


Element 方法: scrollTo {#Element:scrollTo}
--------------------------------------------

将元素内容滚动到指定的坐标(前提是元素内容已经溢出).

该方法对Window对象也可用.

### 语法:

	myElement.scrollTo(x, y);

### 参数:

1. x - (*number*) x坐标
2. y - (*number*) y坐标

### 示例:

	$('myElement').scrollTo(0, 100);

### 另参考:

- [MDC Element:scrollLeft][], [MDC Element:scrollTop][]




Element 方法: getSize {#Element:getSize}
------------------------------------------

获取元素的尺寸(width, height, border, padding都计算在内).

该方法对Window对象也可用.

### 语法:

	myElement.getSize();

### 返回:

* (*object*) 包含了宽度(x)和高度(y)的对象

### 示例:

	var size = myElement.getSize();
	alert("The element is " + size.x + " pixels wide and " + size.y + "pixels high.");




Element 方法: getScrollSize {#Element:getScrollSize}
------------------------------------------------------

获取元素的尺寸(可滚动区域也计算在内).

该方法对Window对象也可用.

### 语法:

	myElement.getScrollSize();

### 返回:

* (*object*) 包含了宽度(键为x)和高度(键为y)的对象

### 示例:

	var scroll = $('myElement').getScrollSize();
	alert('My element can scroll to ' + scroll.y + 'px'); //显示 'My element can scroll down to 820px'

### 另参考:

- [MDC Element:scrollLeft][], [MDC Element:scrollTop][], [MDC Element:offsetWidth][], [MDC Element:offsetHeight][], [MDC Element:scrollWidth][], [MDC Element:scrollHeight][]



Element 方法: getScroll {#Element:getScroll}
----------------------------------------------

获取元素已滚动的距离.

该方法对Window对象也可用.

### 语法:

	myElement.getScroll();

### 返回:

* (*object*) 包含了在x和y坐标上的滚动距离

### 示例:

	var scroll = $('myElement').getScroll();
	alert('My element is scrolled down ' + scroll.y + 'px'); //显示 'My element is scrolled down to 620px'


Element 方法: getPosition {#Element:getPosition}
--------------------------------------------------

获取元素的实际偏移量

### 语法:

	myElement.getPosition(relative);

### 参数:

relative - (Element, 默认为document) 如果设置了该对象, 则以该元素对象为计算的参照物

### 返回:

* (*object*) 元素的x和y坐标值

### 示例:

	$('element').getPosition(); //返回 {x: 100, y: 500};

### 另参考:

- [QuirksMode: Find position](http://www.quirksmode.org/js/findpos.html)


Element 方法: getCoordinates {#Element:getCoordinates}
--------------------------------------------------------

获取元素的width, height, left, right, top, bottom值

### 语法:

	myElement.getCoordinates(relative);

### 参数:

relative - (*element*, 可选, 默认为document) 如果设置了该对象, 则以该元素对象作为计算的参照物

### 返回值:

* (*object*) 包含如下值得对象: top, left, width, height, right, bottom.

### 示例:

	var myValues = $('myElement').getCoordinates();
	
	/*返回:
	{
		top: 50,
		left: 100,
		width: 200,
		height: 300,
		right: 300,
		bottom: 350
	}
	*/

### 另参考:

[Element:getPosition](#Element:getPosition)


[$]: /Element/Element#dollar
[MDC Element:scrollLeft]: http://developer.mozilla.org/en/docs/DOM:element.scrollLeft
[MDC Element:scrollTop]: http://developer.mozilla.org/en/docs/DOM:element.scrollTop
[MDC Element:offsetWidth]: http://developer.mozilla.org/en/docs/DOM:element.offsetWidth
[MDC Element:offsetHeight]: http://developer.mozilla.org/en/docs/DOM:element.offsetHeight
[MDC Element:scrollWidth]: http://developer.mozilla.org/en/docs/DOM:element.scrollWidth
[MDC Element:scrollHeight]: http://developer.mozilla.org/en/docs/DOM:element.scrollHeight