HTML DOM scrollTop プロパティ

元素对象参考手册要素オブジェクト

例

スクロールバーをスライドして、要素のスクロールバーから要素の左端または上端までの距離を取得します:

const element = document.getElementById("myDIV"); let x = elmnt.scrollLeft; let y = elmnt.scrollTop;

試してみる »

定義と使用方法

scrollTop プロパティは、要素のコンテンツが垂直方向にスクロールするピクセル数を取得または設定できます。

要素の scrollTop 値は、その要素のコンテンツの先頭(巻き上げられた部分)から、そのビューポートに表示されるコンテンツ(の先頭)までの距離の尺度です。要素のコンテンツが垂直方向のスクロールバーを生成しない場合、scrollTop 値は 0 になります。

表示倍率を拡大縮小しているシステムでは、scrollTop は小数を返す場合があります。


ブラウザサポート

プロパティ
scrollTop Yes Yes Yes Yes Yes

構文

scrollTop プロパティ値を取得:

// 获得滚动的像素数
var intElemScrollTop = element.scrollTop 

intElemScrollTop は整数で、要素のコンテンツが上にスクロールしたピクセル数です。

scrollLeft プロパティ値を設定:

// 设置滚动的距离
element.scrollTop = intValue;

scrollTop は任意の整数に設定できますが、ただし:

  • 要素がスクロールできない場合(例えば、オーバーフローがない、または要素に「non-scrollable"属性)がある場合)、scrollTopは次のように設定されます0。
  • 設定scrollTopの値が 0 未満の場合、scrollTopに設定されます0
  • このコンテナがスクロールできる範囲を超える値を設定した場合、scrollTop最大値に設定されます。

技術詳細

戻り値: 要素のコンテンツが垂直方向にスクロールしたピクセル数を表す整数を返します。

その他の例

例

ID が "myDIV" の要素を水平方向に 50 ピクセル、垂直方向に 10 ピクセルスクロールさせます:

const element = document.getElementById("myDIV"); element.scrollLeft = 50; element.scrollTop = 10;

試してみる »

例

ID が "myDIV" の要素を、ボタンをクリックするたびに水平方向に 50 ピクセル、垂直方向に 10 ピクセルスクロールさせます:

var elmnt = document.getElementById("content"); function getFunction() { var x = elmnt.scrollWidth; var y = elmnt.scrollHeight; } function setFunction() { elmnt.style.height = y.scrollHeight + "px"; elmnt.style.width = y.scrollWidth + "px"; }

試してみる »


元素对象参考手册要素オブジェクト

その他の拡張