positionedOffset1.6
positionedOffset(element) -> [Number, Number] 或 { left: Number, top: Number }
以 element
的容器块(Containing Block)节点(译注:距离元素最近的 CSS position
属性为 relative
或 absolute
的先代节点)为坐标原点,返回 element
的坐标偏移值(元素的容器块节点可通过 Element#getOffsetParent 方法获取)。
译注:假定返回值为 offset,则 X 轴坐标可通过 offset[0]
获取,也可以通过
offset.left
获取,Y 轴坐标可通过 offset[1]
获取,也可通过 offset.top
获取。
这个方法其实是累加元素及其所有父元素的 offsetLeft
和 offsetTop
,直到其中一个元素的 CSS
position
属性不等于 static
(译注:static
是 position
的默认值)为止。
译注:上一段的描述和代码有些矛盾,原文是这样的:
Calculates the cumulative offsetLeft and offsetTop of an element and all its parents until it reaches an element with a position of static.
但是源代码却是:
positionedOffset: function(element) {
var valueT = 0, valueL = 0;
do {
valueT += element.offsetTop || 0;
valueL += element.offsetLeft || 0;
element = element.offsetParent;
if (element) {
if (element.tagName.toUpperCase() == 'BODY') break;
var p = Element.getStyle(element, 'position');
if (p !== 'static') break; //注意这里,若 position 属性不等于 static,则跳出循环。
}
} while (element);
return Element._returnOffset(valueL, valueT);
}
注意:所有返回值都仅有数字,单位为像素。