CKTIS / CSS
background-size — Hintergrundbilder skalieren
Die Eigenschaft background-size legt die Abmessungen von Hintergrundbildern fest, nicht die des Elements. Sie können feste Größen angeben, auto verwenden oder ein Bild mit contain beziehungsweise cover anpassen.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
background-size: <bg-size>#;
<bg-size> = [ <length-percentage [0,∞]> | auto ]{1,2} | cover | containbackground-size legt die Größe jedes Hintergrundbilds fest, nicht die des Elements. Der Anfangswert ist auto auto; die Eigenschaft wird nicht vererbt.
Bei der Angabe von Breite und Höhe steht der erste Wert für die Breite und der zweite für die Höhe. Wird in dieser Schreibweise nur die Breite angegeben, gilt für die Höhe auto. Längen und Prozentwerte dürfen nicht negativ sein. Prozentwerte beziehen sich auf die entsprechenden Abmessungen des Hintergrundpositionierungsbereichs, der üblicherweise durch background-origin bestimmt wird. auto verwendet, sofern verfügbar, das natürliche Seitenverhältnis und die natürlichen Abmessungen des Bildes; damit ist nicht immer die Originalgröße der Datei gemeint.
contain und cover sind eigenständige Skalierungsmodi, die beide Bildabmessungen bestimmen. contain erhält, sofern vorhanden, das natürliche Seitenverhältnis und passt das ganze Bild in den Bereich ein. cover erhält es ebenfalls und füllt den gesamten Bereich aus; dabei kann ein Teil des Bildinhalts abgeschnitten werden. 100% 100% legt beide Abmessungen unabhängig voneinander fest und kann das Bild verzerren.
Kommas trennen die Größen aufeinanderfolgender background-image-Ebenen; eine zu kurze Liste wird wiederholt, überschüssige Werte werden ignoriert. Die Wiederholung wird separat durch background-repeat gesteuert. In der Kurzschreibweise background folgt die Größe auf Position und /, zum Beispiel background: none center / cover no-repeat.
Beispiele
<!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>Ergebnis
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.
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.