KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

object-fit — inhoud in het vak van een element laten passen

object-fit bepaalt hoe de inhoud van een vervangen element in het inhoudsvak past. De eigenschap kan verhoudingen behouden, een afbeelding bijsnijden of uitrekken zonder de afmetingen van het elementvak te wijzigen.

Versie: 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 bepaalt hoe de inhoud van een vervangen element, zoals een img-afbeelding, in het inhoudsvak past. De eigenschap stelt de afmetingen van dat vak niet vast: in het voorbeeld doen width en height dat. De beginwaarde is fill; de eigenschap wordt niet overgeërfd en de animatie is discreet.

fill vult het vak en kan de verhoudingen vervormen. contain behoudt de verhoudingen en laat alle inhoud passen, mogelijk met lege stroken als gevolg. cover behoudt de verhoudingen en bedekt het hele vak, waarbij zo nodig inhoud wordt bijgesneden. none schaalt de inhoud niet om die te laten passen: de standaardgroottebepaling wordt gebruikt, wat meestal de natuurlijke afmetingen oplevert. scale-down kiest het kleinste resultaat van none en contain.

Lege gebieden tonen de achtergrond van het element; inhoud die buiten het vak valt, wordt afgeknipt. object-position bepaalt de plaatsing. Deze eigenschap past elementinhoud aan, niet een achtergrondafbeelding die met background-size wordt ingesteld.

De Level 4-grammatica staat ook toe om scale-down met contain of cover te combineren; scale-down zonder meer betekent contain scale-down. De variant cover scale-down kiest het kleinste resultaat van none en cover en kan dus lege ruimte overlaten. Dat een combinatie in de specificatie staat, bewijst niet dat browsers deze ondersteunen; combinaties moeten afzonderlijk worden gecontroleerd.

Voorbeelden

<!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">

Resultaat

A 120 × 120 CSS-pixel image box containing a centered 120 × 60 red rectangle, with 30 CSS-pixel gray bands above and below.

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen