Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

object-fit — dopasowanie zawartości do pola elementu

object-fit określa dopasowanie zawartości elementu zastępowanego do jego pola zawartości. Pozwala zachować proporcje, przyciąć obraz lub rozciągnąć go bez zmiany rozmiaru samego pola.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

object-fit: fill | none | [contain | cover] || scale-down;

object-fit steruje dopasowaniem zawartości elementu zastępowanego, np. obrazu img, do jego pola zawartości. Nie ustala rozmiaru tego pola: w przykładzie określają go width i height. Wartość początkowa to fill; właściwość nie jest dziedziczona, a animacja jest dyskretna.

fill wypełnia pole i może zniekształcić proporcje. contain zachowuje proporcje i mieści całą zawartość, pozostawiając ewentualne puste pasy. cover zachowuje proporcje i zakrywa całe pole kosztem przycięcia. none nie dopasowuje rozmiaru do pola: używa domyślnego algorytmu wymiarowania, zwykle wymiarów naturalnych. scale-down wybiera mniejszy wynik spośród none i contain.

Puste obszary pokazują tło elementu, a zawartość wychodząca poza pole jest przycinana. Położenie ustala object-position. To dopasowanie zawartości, nie obraz tła sterowany przez background-size.

Składnia Level 4 pozwala również łączyć scale-down z contain lub cover; samodzielne scale-down oznacza contain scale-down. Wariant cover scale-down wybiera mniejszy wynik spośród none i cover, więc może pozostawić wolne miejsce. Definicja w specyfikacji nie potwierdza obsługi w przeglądarce; kombinacje wymagają osobnej weryfikacji.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła