Element/Dimensions

Type: Element

自定义类型，其所有的方法允许通过$函数生成对象使用。

注意事项:

• 这此方法不考虑body的margin和border,可以考虑内容用一个div包含,并设置body的margin和border为0.
• 如果需要测量没有被display(包含父类没有display),需要使用Element.measure

Element Method: scrollTo

滚动元素到指定坐标(如果元素有overflow样式),此方法可以用于window对象。

语法:

myElement.scrollTo(x, y);

参数:

1. x - (number)的x坐标。
2. y - (number)的y坐标。

例如:

myElement.scrollTo(x, y);

Element Method: getSize

返回元素的高度和宽度，包含borders和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 Method: getScrollSize

返回元素可滚动区域的大小,此方法可用在Window对象上.

语法:

myElement.getScrollSize();

返回:

• (object)包含目标元素的x和y可滚动大小的对象。

例如:

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

Element Method: getScroll

返回一个元素已滚动了多少,此方法也可用在Window对象上.

语法:

myElement.getScroll();

返回:

• (object)包含目标元素已滚动大小的对象。

例如:

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

Element Method: getPosition

返回元素的实际偏移量。

语法:

myElement.getPosition(relative);

参数:

• relative - (Element, defaults to the document) 如果设置，则相对于这个元素。

返回:

• (object) 相对于该元素的距离。

例如:

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

Element Method: setPosition

设置元素的left和top属性(css样式).

语法:

myElement.setPosition(positions);

参数:

1. positions - (object) 一个对象(如{x:100,y:100})

返回:

• (element) 当前元素。

例子:

myElement.setPosition({x: 10, y: 100});

Element Method: getCoordinates

返回一个对象，包含width, height, left, right, top, bottom坐标值.

语法:

var myValues = $('myElement').getCoordinates();

参数:

• relative - (element, optional) 如果设置，将相对于此元素，否则相对于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 Method: getOffsetParent

返回设置了定位的父元素.

语法:

myElement.getOffsetParent();

返回:

• (mixed) 返回有定位属性的父元素，如果没有返回null。