DOM
Element.scrollIntoViewIfNeeded() 方法将不在浏览器窗口的可见区域内的元素滚动到浏览器窗口的可见区域。如果该元素已经在浏览器窗口的可见区域内,则不会发生滚动。此方法是标准的 Element.scrollIntoView() 方法的专有变体。
语法
scrollIntoViewIfNeeded()
scrollIntoViewIfNeeded(centerIfNeeded)
参数
centerIfNeeded- : 一个可选的布尔值,默认为
true:- 如果为
true,则元素将在其所在滚动区的可视区域中居中对齐。 - 如果为
false,则元素将与其所在滚动区的可视区域最近的边缘对齐。根据可见区域最靠近元素的哪个边缘,元素的顶部将与可见区域的顶部边缘对准,或者元素的底部边缘将与可见区域的底部边缘对准。
- 如果为
- : 一个可选的布尔值,默认为
返回值
无(undefined)。
示例
const element = document.getElementById("my-el");
element.scrollIntoViewIfNeeded(); // 将元素置于可见区域的中心
element.scrollIntoViewIfNeeded(false); // 将元素与可见区域中最近的边缘对齐
规范
不属于任何规范。这是一种 WebKit 专有的方法。
浏览器兼容性
参见
- W3C CSSOM bug 17152:支持在元素滚动入视图时将其居中。(等同于
scrollIntoViewIfNeeded的标准特性的请求)
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
