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 | containbackground-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.