--- title: Element.scrollLeft slug: Web/API/Element/scrollLeft tags: - API - scrollLeft translation_of: Web/API/Element/scrollLeft ---

{{ APIRef("DOM") }}

Element.scrollLeft 属性可以读取或设置元素滚动条到元素左边的距离。

注意如果这个元素的内容排列方向({{cssxref("direction")}}) 是rtl (right-to-left) ,那么滚动条会位于最右侧(内容开始处),并且scrollLeft值为0。此时,当你从右到左拖动滚动条时,scrollLeft会从0变为负数。

在使用显示比例缩放的系统上,scrollLeft 可能会是一个小数。

语法

//获取滚动条到元素左边的距离
var sLeft = element.scrollLeft;

sLeft是一个整数,代表元素滚动条距离元素左边多少像素。

//设置滚动条滚动了多少像素
element.scrollLeft = 10;

scrollLeft 可以是任意整数,然而:

示例

HTML

<div id="container">
  <div id="content">Click the button to slide right!</div>
</div>

<button id="slide" type="button">Slide right</button>

CSS

#container {
  width: 100px;
  height: 100px;
  border: 1px solid #ccc;
  overflow-x: scroll;
}

#content {
  width: 250px;
  background-color: #ccc;
}

JavaScript

const button = document.getElementById('slide');

button.onclick = function () {
  document.getElementById('container').scrollLeft += 20;
};

结构

{{EmbedLiveSample("示例")}}

规范

Specification Status Comment
{{SpecName('CSSOM View', '#dom-element-scrollleft', 'scrollLeft')}} {{Spec2("CSSOM View")}}

浏览器兼容

{{Compat("api.Element.scrollLeft")}}

参见