Atributo backgroundSize do estilo

Definição e uso

backgroundSize Defina ou retorne o tamanho da imagem de fundo.

Veja também:

Estilo HTML:Atributo background

Tutorial CSS:Fundo CSS

Tutorial CSS3:Background CSS3

Manual de referência CSS:Atributo background-size

Exemplo

Defina o tamanho da imagem de fundo:

document.getElementById("myDIV").style.backgroundSize = "60px 120px";

Experimente você mesmo

Sintaxe

Retorne o atributo backgroundSize:

object.style.backgroundSize

Defina o atributo backgroundSize:

object.style.backgroundSize = "auto|length|cover|contain|initial|inherit"

Valor do atributo

Valor Descrição
auto Valor padrão. A imagem de fundo contém sua largura e altura.
length

Defina a largura e a altura da imagem de fundo.

O primeiro valor define a largura, o segundo valor define a altura.

Se apenas um valor for fornecido, o segundo é definido como "auto".
percentage

Defina a largura e a altura da imagem de fundo em porcentagem do elemento pai.

O primeiro valor define a largura, o segundo valor define a altura.

Se apenas um valor for fornecido, o segundo é definido como "auto".
cover

Ajuste o tamanho da imagem de fundo o mais possível, para que a área de fundo seja completamente coberta pela imagem de fundo.

Alguns partes da imagem de fundo podem não estar dentro da área de localização do fundo.
contain Ajuste o tamanho da imagem para o tamanho máximo, para que a largura e a altura sejam adequadas para a área de conteúdo.
initial Defina este atributo para seu valor padrão. Veja initial.
inherit Herda este atributo do elemento pai. Veja inherit.

Detalhes técnicos

Valor padrão: auto
Valor de retorno: Cadeia de caracteres, que representa o Atributo background-size.
Versão do CSS: CSS3

Suporte do navegador

backgroundSize é uma característica do CSS3 (1999).

Todos os navegadores suportam completamente:

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