CKTIS / CSS
object-fit — přizpůsobení obsahu do rámečku prvku
object-fit určuje, jak se obsah nahrazovaného prvku přizpůsobí jeho obsahovému rámečku. Umožňuje zachovat proporce, oříznout obrázek nebo jej roztáhnout, aniž by se změnily rozměry rámečku prvku.
Verze: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
object-fit: fill | none | [contain | cover] || scale-down;object-fit řídí, jak se obsah nahrazovaného prvku, například obrázku img, přizpůsobí jeho obsahovému rámečku. Rozměry rámečku tato vlastnost neurčuje: v příkladu je určují width a height. Počáteční hodnota je fill; vlastnost se nedědí a její animace je diskrétní.
fill vyplní rámeček a může zdeformovat proporce. contain proporce zachová a vejde se do něj celý obsah, případně za cenu prázdných pruhů. cover zachová proporce a pokryje celý rámeček; podle potřeby obsah ořízne. none obsah nezmenšuje ani nezvětšuje, aby se vešel: použije výchozí algoritmus určování velikosti, který obvykle vede k přirozeným rozměrům. scale-down zvolí menší výsledek z none a contain.
Prázdné oblasti zobrazují pozadí prvku a obsah přesahující rámeček se ořízne. Umístění řídí object-position. Vlastnost přizpůsobuje obsah prvku, nikoli obrázek na pozadí řízený pomocí background-size.
Gramatika úrovně 4 umožňuje také kombinovat scale-down s contain nebo cover; samostatné scale-down znamená contain scale-down. Varianta cover scale-down zvolí menší výsledek z none a cover, takže může ponechat volné místo. Zahrnutí kombinace do specifikace nepotvrzuje její podporu v prohlížečích; kombinace je třeba ověřovat samostatně.
Příklady
<!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">Výsledek
A 120 × 120 CSS-pixel image box containing a centered 120 × 60 red rectangle, with 30 CSS-pixel gray bands above and below.
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.