最近做一个移动专题中看到别人使用这个API实现进入页面就能置顶特定的元素,看了一下文档才发现还可以解决Android下虚拟键盘出来而页面没有上移的情况。今天一起来看看scrollIntoView与scrollIntoViewIfNeed的API以及实际应用。
scrolltoView
尽可能(向上或向下)滚动浏览器窗口或容器元素,以便在当前视窗的可见范围看见当前元素。
存在三个重载参数:
element.scrollIntoView();
不显示声明任何参数,则相当于是element.scrollIntoView(true)
- element.scrollIntoView(alignToTop);
Boolean
类型参数- 如果为
true
,则元素的顶部将尽可能滚动到与父元素可见区域顶部对齐的位置,这是默认值。 - 如果为
false
,则元素的底部将尽可能滚动到与父元素可见区域底部对齐的位置
- 如果为
- 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)
,
- behavior:定义了元素滚动的行为,
需要注意的是,无论是滚动到父元素的顶部还是底部,并不代表子元素会完全滚动到那个位置,浏览器只是尽可能让子元素完全与父元素顶部或者底部对齐,但也有可能滚动到的位置距离父元素顶部或者底部还差一些距离,这取决于页面中其他元素的布局。
至于其兼容性,MDN上说这是一个实验性的 API,并不在 DOM规范中,但到 caniuse.com上一看,发现几乎所有浏览器都支持这个 API:
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)
- 如果设置为 true,并且当前元素在视窗的可见范围内不可见,元素将尽量滚动到父元素可视区域的中部位置(垂直方向)
- 如果设置为 false,并且当前元素在视窗的可见范围内不可见,元素将尽量滚动到父元素可视区域距离最近的一边,至于到底滚动到父元素的顶部还是底部,取决于滚动的子元素距离父元素的哪一边比较近。
MDN
声明此API
是非标准的方法,支持的浏览器也比较少,不过如果只是考虑移动端的场景,那么完全是可以使用的。
实际应用
在移动端安卓 键盘出来覆盖页面(页面没有上移)
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(); }); }) }