Propriedade scrollLeft do Elemento DOM HTML

Definição e uso

scrollLeft Propriedade que define ou retorna o número de pixels de rolagem horizontal do conteúdo do elemento.

Veja também:

Propriedade scrollTop

Propriedade overflow do CSS

Evento onscroll

Exemplo

Exemplo 1

Obtenha o número de pixels de rolagem do conteúdo do "myDIV":

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

Experimente você mesmo

Exemplo 2

Role horizontalmente o conteúdo de "myDIV" para 50 pixels e verticalmente para 10 pixels:

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

Experimente você mesmo

Exemplo 3

Role horizontalmente o conteúdo de "myDIV" em 50 pixels e verticalmente em 10 pixels:

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

Experimente você mesmo

Exemplo 4

Role horizontalmente o conteúdo do <body> em 30 pixels e verticalmente em 10 pixels:

const html = document.documentElement;
html.scrollLeft += 30;
html.scrollTop += 10;

Experimente você mesmo

Sintaxe

Retorne a propriedade scrollLeft:

element.scrollLeft

Defina a propriedade scrollLeft:

element.scrollLeft = pixels

Valor do atributo

Valor Descrição
pixels

Número de pixels de rolagem horizontal do conteúdo do elemento.

  • Se esse número for negativo, configure esse número como 0.
  • Se o elemento não puder ser rolado, configure esse número como 0.
  • Se esse número for maior que o valor máximo permitido, configure esse número como o valor máximo.

Valor de retorno

Tipo Descrição
Número Número de pixels de rolagem horizontal do conteúdo do elemento.

Suporte do navegador

Todos os navegadores suportam element.scrollLeft:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Suporte Suporte Suporte Suporte Suporte Suporte