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 的方法。

瀏覽器相容性

另見