---
title: Element.scrollBy()
slug: Web/API/Element/scrollBy
tags:
  - API
  - Element
  - Method
  - Reference
  - scrollBy
translation_of: Web/API/Element/scrollBy
---
<div>{{ APIRef() }}</div>

<p> <strong><code>scrollBy()</code></strong> 方法是使得元素滚动一段特定距离的 {{domxref("Element")}} 接口。</p>

<h2 id="Syntax">Syntax</h2>

<pre class="syntaxbox">element.scrollBy(<em>x-coord</em>, <em>y-coord</em>);
element.scrollBy(options)
</pre>

<h3 id="Parameters">Parameters</h3>

<ul>
 <li><code>x-coord</code> 是元素要在横轴上滚动的距离。</li>
 <li><code>y-coord</code> 是元素要在纵轴上滚动的距离。</li>
</ul>

<p>- or -</p>

<ul>
 <li><code>options</code> 是一个 {{domxref("ScrollToOptions")}} 字典。</li>
</ul>

<h2 id="例子">例子</h2>

<pre class="brush: js">// 让元素滚动
element.scrollBy(300, 300);
</pre>

<p>使用 <code>options</code>:</p>

<pre class="brush: js">element.scrollBy({
  top: 100,
  left: 100,
  behavior: 'smooth'
});</pre>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">规范</th>
   <th scope="col">状态</th>
   <th scope="col">注释</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{ SpecName('CSSOM View', '#dom-element-scrollby-options-options', 'element.scrollBy()') }}</td>
   <td>{{ Spec2('CSSOM View') }}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性"> 浏览器兼容性</h2>



<p>{{Compat("api.Element.scrollBy")}}</p>