Element: scrollIntoViewIfNeeded() 方法
非標準:此特性未標準化。我們不建議在生產環境中使用非標準特性,因為它們瀏覽器支援有限,並且可能會更改或被移除。但是,在沒有標準選項的特定情況下,它們可以是合適的替代方案。
Element.scrollIntoViewIfNeeded() 方法會在元素不在瀏覽器視窗可見區域內時,將其滾動至可見區域。如果元素已經在瀏覽器視窗可見區域內,則不執行滾動。此方法是標準 Element.scrollIntoView() 方法的一個專有變體。
語法
js
scrollIntoViewIfNeeded()
scrollIntoViewIfNeeded(centerIfNeeded)
引數
centerIfNeeded可選-
一個可選的布林值,預設為
true。- 如果為
true,元素將居中對齊於可滾動祖先元素的可視區域。 - 如果為
false,元素將對齊於可滾動祖先元素可視區域的最近邊緣。根據可視區域的哪個邊緣最靠近元素,元素的頂部將對齊於可視區域的頂部邊緣,或者元素的底部邊緣將對齊於可視區域的底部邊緣。
- 如果為
返回值
無(undefined)。
示例
js
const element = document.getElementById("my-el");
element.scrollIntoViewIfNeeded(); // Centers the element in the visible area
element.scrollIntoViewIfNeeded(false); // Aligns the element to the nearest edge in the visible area
規範
不屬於任何規範。這是一個專有的、特定於 WebKit 的方法。
瀏覽器相容性
載入中…
另見
- W3C CSSOM bug 17152: 支援滾動元素進入檢視時使其居中。(針對
scrollIntoViewIfNeeded標準化等價物的特性請求)