Propriedade de fundo repetido de estilo

Definição e uso

backgroundRepeat Configuração ou retorno de como repetir (tiling) a imagem de fundo.

Veja também:

Estilos HTML:Propriedade background

Tutorial CSS:Fundo CSS

Tutorial CSS3:Background CSS3

Manual CSS:Propriedade background-repeat

Exemplo

Exemplo 1

Definir a imagem de fundo para não se repetir (no-repeat):

document.body.style.backgroundRepeat = "repeat-y";

Experimente você mesmo

Exemplo 2

Alterar a propriedade backgroundRepeat do elemento DIV especificado:

document.getElementById("myDIV").style.backgroundRepeat = "repeat-x";

Experimente você mesmo

Exemplo 3

Definir a repetição da imagem de fundo horizontal ou verticalmente:

function repeatVer() {
  document.body.style.backgroundRepeat = "repeat-y";
}
function repeatHor() {
  document.body.style.backgroundRepeat = "repeat-x";
}

Experimente você mesmo

Exemplo 4

Retornar o valor background-repeat do documento:

alert(document.body.style.backgroundRepeat);

Experimente você mesmo

Sintaxe

Retornar a propriedade backgroundRepeat:

objeto.style.backgroundRepeat

Definir a propriedade backgroundRepeat:

objeto.style.backgroundRepeat = "repeat|repeat-x|repeat-y|no-repeat|initial|inherit"

Valor da propriedade

Valor Descrição
repeat A imagem de fundo se repete vertical e horizontalmente. Padrão.
repeat-x A imagem de fundo se repete horizontalmente.
repeat-y A imagem de fundo se repete verticalmente.
no-repeat A imagem de fundo não se repete.
initial Defina essa propriedade como seu valor padrão. Veja initial.
inherit Herda essa propriedade do elemento pai. Veja inherit.

Detalhes técnicos

Valor padrão: repeat
Retorno: String que representa como a imagem de fundo se repete.
Versão do CSS: CSS1

Suporte do navegador

backgroundRepeat É uma característica do CSS1 (1996).

Todos os navegadores suportam completamente:

Chrome Edge Firefox Safari Ópera IE
Chrome Edge Firefox Safari Ópera IE
Suporte Suporte Suporte Suporte Suporte Suporte