最近做一个移动专题中看到别人使用这个API实现进入页面就能置顶特定的元素,看了一下文档才发现还可以解决Android下虚拟键盘出来而页面没有上移的情况。今天一起来看看scrollIntoViewscrollIntoViewIfNeed的API以及实际应用。

scrolltoView

尽可能(向上或向下)滚动浏览器窗口或容器元素,以便在当前视窗的可见范围看见当前元素。
存在三个重载参数:

  1. element.scrollIntoView();不显示声明任何参数,则相当于是element.scrollIntoView(true)
  2. element.scrollIntoView(alignToTop);Boolean类型参数
    • 如果为 true,则元素的顶部将尽可能滚动到与父元素可见区域顶部对齐的位置,这是默认值。
    • 如果为 false,则元素的底部将尽可能滚动到与父元素可见区域底部对齐的位置
  3. element.scrollIntoView(scrollIntoViewOptions);
    Object类型参数
    {
    behavior: 'auto' | 'instant' | 'smooth',
    block: 'start' | 'end'
    }

    • behavior:定义了元素滚动的行为,instant代表是立即滚动元素,smooth代表动画性的平滑滚动,但大部分浏览器并不支持smooth这个属性值,一般都是 instant
    • block:定义了元素滚动的方向,对应Boolean类型参数,如果设置了start值,则相当于是设置了element.scrollIntoView(true),如果设置了end值,则相当于是设置了element.scrollIntoView(false)

需要注意的是,无论是滚动到父元素的顶部还是底部,并不代表子元素会完全滚动到那个位置,浏览器只是尽可能让子元素完全与父元素顶部或者底部对齐,但也有可能滚动到的位置距离父元素顶部或者底部还差一些距离,这取决于页面中其他元素的布局。

至于其兼容性,MDN上说这是一个实验性的 API,并不在 DOM规范中,但到 caniuse.com上一看,发现几乎所有浏览器都支持这个 API:

scrollIntoView与scrollIntoViewIfNeed学习及应用-风君雪科技博客

MDN上示例如下:

var element = document.getElementById("box");

element.scrollIntoView();
element.scrollIntoView(false);
element.scrollIntoView({block: "end"});
element.scrollIntoView({block: "end", behavior: "smooth"});

scrollIntoViewIfNeeded

只在当前元素在视窗的可见范围内不可见的情况下,才滚动浏览器窗口或容器元素,最终让当前元素可见。如果当前元素在视窗中已经可见了,那么这个方法将不做任何处理,此方法是对Element.scrolltoView()的进一步补充。
存在一个Boolean类型参数:
Element.scrollIntoViewIfNeeded(opt_center)

  1. 如果设置为 true,并且当前元素在视窗的可见范围内不可见,元素将尽量滚动到父元素可视区域的中部位置(垂直方向)
  2. 如果设置为 false,并且当前元素在视窗的可见范围内不可见,元素将尽量滚动到父元素可视区域距离最近的一边,至于到底滚动到父元素的顶部还是底部,取决于滚动的子元素距离父元素的哪一边比较近。

MDN 声明此API是非标准的方法,支持的浏览器也比较少,不过如果只是考虑移动端的场景,那么完全是可以使用的。

scrollIntoView与scrollIntoViewIfNeed学习及应用-风君雪科技博客

实际应用

在移动端安卓 键盘出来覆盖页面(页面没有上移)

if (/Android/gi.test(navigator.userAgent)) {
window.addEventListener('resize', function () {
if (document.activeElement.tagName == 'INPUT' || document.activeElement.tagName == 'TEXTAREA') {
window.setTimeout(function () {
document.activeElement.scrollIntoViewIfNeeded();
}, 0);
}
$('#orderidNum').blur(function(){
document.activeElement.scrollIntoViewIfNeeded();
});
})
}