Element:scrollIntoViewIfNeeded() 方法
非标准: 该特性是非标准的,请尽量不要在生产环境中使用它!
Element.scrollIntoViewIfNeeded()
方法将不在浏览器窗口的可见区域内的元素滚动到浏览器窗口的可见区域。如果该元素已经在浏览器窗口的可见区域内,则不会发生滚动。此方法是标准的 Element.scrollIntoView()
方法的专有变体。
语法
js
scrollIntoViewIfNeeded()
scrollIntoViewIfNeeded(centerIfNeeded)
参数
centerIfNeeded
可选-
一个可选的布尔值,默认为
true
:- 如果为
true
,则元素将在其所在滚动区的可视区域中居中对齐。 - 如果为
false
,则元素将与其所在滚动区的可视区域最近的边缘对齐。根据可见区域最靠近元素的哪个边缘,元素的顶部将与可见区域的顶部边缘对准,或者元素的底部边缘将与可见区域的底部边缘对准。
- 如果为
返回值
无(undefined
)。
示例
js
const element = document.getElementById("my-el");
element.scrollIntoViewIfNeeded(); // 将元素置于可见区域的中心
element.scrollIntoViewIfNeeded(false); // 将元素与可见区域中最近的边缘对齐
规范
不属于任何规范。这是一种 WebKit 专有的方法。
浏览器兼容性
BCD tables only load in the browser
参见
- W3C CSSOM bug 17152:支持在元素滚动入视图时将其居中。(等同于
scrollIntoViewIfNeeded
的标准特性的请求)