---
title: Window.scrollBy()
slug: Web/API/Window/scrollBy
tags:
  - API
  - CSSOM View
  - Método(2)
  - NeedsCompatTable
  - NeedsSpecTable
  - Referencia
translation_of: Web/API/Window/scrollBy
---
<p>{{ APIRef() }}</p>

<h2 id="Summary" name="Summary">Resumen</h2>

<p>Desplaza el documento el número de pixels proporcionados.</p>

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

<pre>window.scrollBy(<em>X</em>, <em>Y</em>);
window.scrollBy(opciones)</pre>

<h3 id="Parameters" name="Parameters">Parámetros</h3>

<ul>
 <li><code>X</code> es el número de pixels a desplazar horizontalmente.</li>
 <li><code>Y</code> es el número de pixels a desplazar verticalmente.</li>
</ul>

<p>Si X o Y son positivos, desplazarán la página hacia la derecha o hacia abajo respectivamente. Si son negativos, la desplazarán hacia la izquierda o hacia arriba respectivamente.</p>

<p>- or -</p>

<ul>
 <li><font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">opciones</span></font> es un objeto con tres posibles propiedades:

  <ul>
   <li><font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">top</span></font>, que es lo mismo que <font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">Y</span></font></li>
   <li><font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">left</span></font>, que es lo mismo que X</li>
   <li><font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">behavior</span></font>, que es un string cuyo valor puede ser <font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">smooth</span></font>, <font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">instant</span></font>, or <font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">auto</span></font>. Por defecto el valor es <font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">auto</span></font></li>
  </ul>
 </li>
</ul>

<h2 id="Example" name="Example">Ejemplo</h2>

<pre class="eval">// Desplazarse la longitud de una página
window.scrollBy(0, window.innerHeight);
</pre>

<p>Para hacer scroll hacia arriba:</p>

<pre>window.scrollBy(0, -window.innerHeight);</pre>

<p>Utilizando <font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">opciones</span></font>:</p>

<pre>window.scrollBy({
  top: 100,
  left: 100,
  behaviour: 'smooth'
})</pre>

<h2 id="Notes" name="Notes">Notas</h2>

<p><a href="/en-US/docs/DOM/Window.scrollBy">window.scrollBy</a> desplaza el documento una cantidad determinada, mientras que <a href="/en-US/docs/DOM/Window.scroll">window.scroll</a> lo hace hacia una posición absoluta en el documento. Vea también <a href="/en-US/docs/DOM/Window.scrollByLines">window.scrollByLines</a>, <a href="/en-US/docs/DOM/Window.scrollByPages">window.scrollByPages</a></p>

<h2 id="Specification" name="Specification">Especificación</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Especificación</th>
   <th scope="col">Estado</th>
   <th scope="col">Comentarios</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{ SpecName('CSSOM View', '#dom-window-scrollby', 'window.scrollBy()') }}</td>
   <td>{{ Spec2('CSSOM View') }}</td>
   <td>Definición inicial.</td>
  </tr>
 </tbody>
</table>