CKTIS / CSS
background-size — rozmiar obrazów tła
Właściwość background-size określa rozmiar obrazów tła, a nie elementu. Pozwala podać wymiary, użyć auto lub dopasować obraz przez contain albo cover.
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
background-size: <bg-size>#;
<bg-size> = [ <length-percentage [0,∞]> | auto ]{1,2} | cover | containbackground-size ustala rozmiar każdego obrazu tła, nie rozmiar elementu. Wartość początkowa to auto auto; właściwość nie jest dziedziczona.
W zapisie określającym wymiary pierwsza wartość oznacza szerokość, a druga wysokość. Jeśli w tym zapisie podano tylko szerokość, wysokość przyjmuje wartość auto. Długości i procenty muszą być nieujemne. Procenty odnoszą się do odpowiednich wymiarów obszaru pozycjonowania tła, zwykle określanego przez background-origin. auto wykorzystuje naturalne proporcje i wymiary obrazu, jeśli istnieją; nie zawsze oznacza rozmiar oryginalnego pliku.
contain i cover to samodzielne tryby dopasowania, które wyznaczają oba wymiary obrazu. contain zachowuje naturalne proporcje, jeśli istnieją, i mieści cały obraz w obszarze. cover zachowuje je i pokrywa cały obszar; część obrazu może zostać przycięta. 100% 100% ustala oba wymiary niezależnie i może zniekształcić obraz.
Przecinki rozdzielają rozmiary kolejnych warstw background-image; zbyt krótka lista jest powtarzana, nadmiarowe wartości są pomijane. Powtarzaniem steruje osobno background-repeat. W skrócie background rozmiar występuje po pozycji i /, np. background: none center / cover no-repeat.
Przykłady
<!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>Wynik
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.
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.