打印

BX9008: 各浏览器对于获取文档水平及垂直方向滚动条位置(scrollLeft、scrollTop)时的参考元素存在差异

作者:陆远

标准参考

问题描述

针对获取页面的垂直滚动条的位置,IE Firefox Opera 标准模式下使用 document.documentElement.scrollLeft 获取页面的水平滚动条位置,而混杂模式下则是使用 document.body.scrollLeft。Chrome Safari 在两种文档模式下均使用 document.body.scrollLeft 获取页面的水平滚动条位置。
同理,针对获取页面的水平滚动条的位置的情况与上面类似。

造成的影响

在混杂模式下,由于所有浏览器均使用 document.body.scrollTop 获取页面的垂直滚动条的位置,所以不会出现兼容性问题。
而在标准模式下,由于 Chrome 与 Safari 仍然使用 document.body.scrollTop,而对于 document.documentElement.scrollTop 返回为 0。这时如果仅仅使用 document.documentElement.scrollTop 获取页面垂直滚动条顶端位置,则在 Chrome 和 Safari 中就会因为永久返回 0 导致页面运行异常(如,绝对定位的元素不能随页面的滚动条而滚动或位置有误)。
对于获取页面的水平滚动条的位置,情况与上面描述类似。

受影响的浏览器

所有浏览器  

问题分析

Element.scrollTop 及 Element.scrollLeft 不是 W3C 规范的标准属性,最初被 IE 的 DHTML Object Model 引入,但已被目前各主流浏览器所支持。更多参见 MSDN:scrollTop PropertyscrollLeft Property

  • Element.scrollTop 属性获取或者设置一个元素的内容已经滚动到其上边界的像素数。只有在元素具备垂直滚动条的时候此属性才有效。
  • Element.scrollLeft 属性获取或者设置一个元素的内容已经滚动到其左边界的像素数。只有在元素具备水平滚动条的时候此属性才有效。

而无论是 MSDN 还是 Mozilla Developer Center,均没有明确提及对于页面(即视口元素)的滚动条,其垂直与水平的位置需要通过哪一个 DOM 对象获取。

分析以下代码:

<html>
<head>
<script>
  var d, str;
  window.onload = window.onscroll = function () {
    d = document.getElementById("d");
    str = "<strong>" + ((document.compatMode.toLowerCase().indexOf("back") >= 0) ? "Quirks" : "Standards") + "</strong><br />"
      + "document.documentElement.scrollTop:" + document.documentElement.scrollTop + "<br />"
      + "document.documentElement.scrollLeft:" + document.documentElement.scrollLeft + "<br />"
      + "document.body.scrollTop:" + document.body.scrollTop + "<br />"
      + "document.body.scrollLeft:" + document.body.scrollLeft;
    d.innerHTML = str;
  }
</script>
</head>
<body style="font:12px Arial; _background-attachment:fixed; _background-image:url(about:blank);">
<div style="width:10000px; height:10000px;"></div>
<div id="d" style="position:fixed; top:0; left:0; _position:absolute; _top:expression(offsetParent.scrollTop); _left:expression(offsetParent.scrollLeft); background:#ddd;"></div>
</body>
</html>

测试代码中,当在页面中改变垂直滚动条与水平滚动条的位置,会动态地在灰色背景的 DIV 元素中显示出当前页面的文档模式以及 document.documentElement.scrollTop document.documentElement.scrollLeft document.body.scrollTop document.body.scrollLeft 这四个属性的返回值。

不同的浏览器运行的结果列表如下:

  IE6 IE7 IE8 Firefox Opera Chrome Safari
文档模式 Quirks Standards Quirks Standards
document.documentElement.scrollTop 0 垂直滚动条的实际位置 0 0
document.documentElement.scrollLeft 0 水平滚动条的实际位置 0 0
document.body.scrollTop 垂直滚动条的实际位置 0 垂直滚动条的实际位置 垂直滚动条的实际位置
document.body.scrollLeft 水平滚动条的实际位置 0 水平滚动条的实际位置 水平滚动条的实际位置

通过上表可知:

  • IE6 IE7 IE8 Firefox Opera 中,标准模式下分别使用 document.documentElement.scrollTopdocument.documentElement.scrollLeft 获取页面的垂直与水平滚动条的位置,混杂模式下使用 document.body.scrollTopdocument.body.scrollLeft 获取页面的垂直与水平滚动条的位置。
  • Chrome Safari 中,标准模式与混杂模式下均使用 document.body.scrollTopdocument.body.scrollLeft 获取页面的垂直与水平滚动条的位置。

引申资料:

我们通过 WebKit 内核与 Gecko 内核的源代码中也可以看出 Chrome Safari 与 Firefox 对页面的 scrollTop scrollTop 获取方式的不同:

WebKit 内核:/WebCore/html/HTMLBodyElement.cpp

int HTMLBodyElement::scrollTop() const
{
    // Update the document's layout.
    Document* doc = document();
    doc->updateLayoutIgnorePendingStylesheets();
    FrameView* view = doc->view();
    return view ? adjustForZoom(view->scrollY(), view) : 0;
}

int HTMLBodyElement::scrollLeft() const
{
    // Update the document's layout.
    Document* doc = document();
    doc->updateLayoutIgnorePendingStylesheets();
    FrameView* view = doc->view();
    return view ? adjustForZoom(view->scrollX(), view) : 0;
}

Gecko 内核:/content/base/src/nsGenericElement.cpp

nsNSElementTearoff::GetScrollInfo(nsIScrollableView **aScrollableView,
                                  nsIFrame **aFrame)
{
    ...
    if ((quirksMode && mContent->NodeInfo()->Equals(nsGkAtoms::body)) ||
        (!quirksMode && mContent->NodeInfo()->Equals(nsGkAtoms::html))) {
      // In quirks mode, the scroll info for the body element should map to the
      // scroll info for the nearest scrollable frame above the body element
      // (i.e. the root scrollable frame).  This is what IE6 does in quirks
      // mode.  In strict mode the root scrollable frame corresponds to the
      // html element in IE6, so we map the scroll info for the html element to
      // the root scrollable frame.

      do {
        frame = frame->GetParent();

        if (!frame) {
          break;
        }

        scrollFrame = do_QueryFrame(frame);
      }
    ...
}

Firefox 的 Gecko 内核源代码中通过对文档模式的判断决定通过哪个对象获取和设置 scrollTop scrollLeft 属性。从注释中可以看到,Firefox 这么做是为了兼容 IE6 的标准模式与混杂模式对这两者的处理。

而 WebKit 内核则没有针对文档模式进行判断,对页面滚动条信息通过 [Object HTMLBodyElement] 对象获取与设置。

解决方案

使用 "||" 逻辑语句将这两种获取方式相连,以保证兼容性。如:

var scrollTop = document.documentElement.scrollTop || document.body.scrollTop;
var scrollLeft = document.documentElement.scrollLeft || document.body.scrollLeft;

参见

知识库

相关问题

测试环境

操作系统版本: Windows 7 Ultimate build 7600
浏览器版本: IE6
IE7
IE8
Firefox 3.6
Chrome 5.0.342.2 dev
Safari 4.0.5
Opera 10.50
测试页面: scroll_Quirks.html
scroll_Standards.html
本文更新时间: 2010-07-15

关键字

scrollLeft scrollTop document documentElement BODY 滚动 视口