Native: Element

Custom Native to allow all of its methods to be used with any DOM element via the dollar function $.

Note:

These methods don't take into consideration the body element margins and borders. If you need margin/borders on the body, consider adding a wrapper div, but always reset the margin and borders of body to 0.

Credits:

• Element positioning based on the qooxdoo code and smart browser fixes, LGPL License.
• Viewport dimensions based on YUI code, BSD License.

Element Method: scrollTo

Scrolls the element to the specified coordinated (if the element has an overflow). The following method is also available on the Window object.

Синтаксис:

myElement.scrollTo(x, y);

Аргументы:

1. x - (number) The x coordinate.
2. y - (number) The y coordinate.

Пример:

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

Смотрите также:

• MDC Element:scrollLeft, MDC Element:scrollTop

Element Method: getSize

Returns the height and width of the Element, taking into account borders and padding. The following method is also available on the Window object.

Синтаксис:

myElement.getSize();

Возвращает:

• (object) An object containing the width (as x) and the height (as y) of the target Element.

Пример:

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

Element Method: getScrollSize

Returns an Object representing the size of the target Element, including scrollable area. The following method is also available on the Window object.

Синтаксис:

myElement.getScrollSize();

Возвращает:

• (object) An object containing the x and y dimensions of the target Element.

Пример:

var scroll = $('myElement').getScrollSize();

alert('My element can scroll to ' + scroll.y + 'px'); //alerts '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 Method: getScroll

Returns an Object representing how far the target Element is scrolled in either direction. The following method is also available on the Window object.

Синтаксис:

myElement.getScroll();

Возвращает:

• (object) An object containing the x and y dimensions of the target Element's scroll.

Пример:

var scroll = $('myElement').getScroll();

alert('My element is scrolled down ' + scroll.y + 'px'); //alerts 'My element is scrolled down to 620px'

Element Method: getPosition

Returns the real offsets of the element.

Синтаксис:

myElement.getPosition(relative);

Аргументы:

relative - (Element, defaults to the document) If set, the position will be relative to this Element.

Возвращает:

• (object) An object with the x and y coordinates of the Element's position.

Пример:

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

Смотрите также:

• QuirksMode: Find position

Element Method: getCoordinates

Returns an object with width, height, left, right, top, and bottom coordinate values of the Element.

Синтаксис:

myElement.getCoordinates(relative);

Аргументы:

relative - (element, optional) if set, the position will be relative to this element, otherwise relative to the document.

Возвращает:

• (object) An object containing the Element's current: top, left, width, height, right, and bottom.

Пример:

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

Возвращает:

{
    top: 50,
    left: 100,
    width: 200,
    height: 300,
    right: 300,
    bottom: 350

}

Смотрите также:

Element:getPosition