CKTIS / CSS
object-fit – Inhalt an das Elementfeld anpassen
object-fit legt fest, wie der Inhalt eines ersetzten Elements in dessen Inhaltsfeld eingepasst wird. Damit lassen sich Seitenverhältnisse erhalten, Bilder zuschneiden oder Inhalte strecken, ohne die Größe des Elementfelds zu ändern.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
object-fit: fill | none | [contain | cover] || scale-down;object-fit steuert, wie der Inhalt eines ersetzten Elements, etwa eines img-Bildes, in dessen Inhaltsfeld eingepasst wird. Die Abmessungen dieses Feldes legt die Eigenschaft nicht fest: Im Beispiel übernehmen das width und height. Der Anfangswert ist fill; die Eigenschaft wird nicht vererbt und ihre Animation erfolgt diskret.
fill füllt das Feld aus und kann dabei die Proportionen verzerren. contain erhält die Proportionen und passt den gesamten Inhalt ein; dabei können leere Streifen übrig bleiben. cover erhält die Proportionen und deckt das ganze Feld ab, wobei nötigenfalls Inhalte abgeschnitten werden. none passt die Größe nicht an das Feld an, sondern verwendet den standardmäßigen Größenalgorithmus, üblicherweise die natürlichen Abmessungen. scale-down wählt das kleinere Ergebnis von none und contain.
Leere Bereiche zeigen den Hintergrund des Elements; Inhalte, die über das Feld hinausragen, werden abgeschnitten. object-position legt die Position fest. Die Eigenschaft passt Elementinhalte ein, nicht ein Hintergrundbild, das mit background-size gesteuert wird.
Die Level-4-Grammatik erlaubt auch, scale-down mit contain oder cover zu kombinieren; alleinstehendes scale-down bedeutet contain scale-down. Die Variante cover scale-down wählt das kleinere Ergebnis von none und cover und kann daher freien Platz lassen. Dass eine Kombination in der Spezifikation enthalten ist, belegt nicht ihre Browserunterstützung; solche Kombinationen müssen separat überprüft werden.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>object-fit: contain</title>
<style>
img {
display: block;
width: 120px;
height: 120px;
object-fit: contain;
object-position: center;
background: #ddd;
}
</style>
<img alt="Red rectangle" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='200' height='100' viewBox='0 0 200 100'%3E%3Cpath fill='red' d='M0 0H200V100H0Z'/%3E%3C/svg%3E">Ergebnis
A 120 × 120 CSS-pixel image box containing a centered 120 × 60 red rectangle, with 30 CSS-pixel gray bands above and below.
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.