Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

background-size — dimensionar imagens de fundo

A propriedade background-size controla as dimensões das imagens de fundo, não as do elemento. Permite indicar dimensões, usar auto ou ajustar uma imagem com contain ou cover.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

background-size: <bg-size>#;
<bg-size> = [ <length-percentage [0,∞]> | auto ]{1,2} | cover | contain

background-size define o tamanho de cada imagem de fundo, não o do elemento. O valor inicial é auto auto e a propriedade não é herdada.

Na sintaxe de largura e altura, o primeiro valor especifica a largura e o segundo, a altura. Se nesta sintaxe só for indicada a largura, a altura assume o valor auto. Comprimentos e percentagens têm de ser não negativos. As percentagens referem-se às dimensões correspondentes da área de posicionamento do fundo, normalmente determinada por background-origin. auto utiliza as dimensões e a proporção naturais da imagem, quando disponíveis; nem sempre significa o tamanho do ficheiro original.

contain e cover são modos de ajuste autónomos que determinam ambas as dimensões da imagem. contain mantém a proporção natural, se existir, e ajusta a imagem inteira à área. cover também a mantém e cobre toda a área; parte da imagem pode ser cortada. 100% 100% define as duas dimensões de forma independente e pode distorcer a imagem.

As vírgulas separam os tamanhos das camadas sucessivas de background-image; uma lista demasiado curta é repetida e os valores excedentários são ignorados. A repetição é controlada separadamente por background-repeat. Na forma abreviada background, o tamanho surge depois da posição e de /, por exemplo background: none center / cover no-repeat.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>background-size</title>
<style>
  .sample {
    width: 200px;
    height: 120px;
    background-color: #ddd;
    background-image: linear-gradient(to right, #06c 50%, #fc0 50%);
    background-size: 50% 50%;
    background-position: center;
    background-repeat: no-repeat;
  }
</style>
<div class="sample"></div>

Resultado

A 200 × 120 CSS-pixel gray rectangle contains a centered 100 × 60 CSS-pixel image: its left half is blue and its right half is yellow.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes