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";
}
試してみる »
その他の拡張
要素オブジェクト