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