Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

object-position — położenie zawartości obrazu

Właściwość object-position wyrównuje zawartość elementu zastępowanego, np. img, w jego polu zawartości. Pozwala wybrać widoczny fragment przy kadrowaniu, nie przesuwając samego elementu w układzie.

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

Składnia

object-position: <position>;
/* Examples */
object-position: center;
object-position: 25% 75%;
object-position: right 10px bottom 20px;

object-position ustala położenie zawartości elementu zastępowanego, np. img, wewnątrz jego pola zawartości. Wartość początkowa to 50% 50%; właściwość jest dziedziczona. object-fit określa rozmiar zawartości, a object-position jej wyrównanie — nie położenie elementu w układzie.

Typ <position> przyjmuje słowa left, right, top, bottom, center, długości i procenty. W zapisie dwóch wartości liczbowych pierwsza dotyczy osi poziomej, druga pionowej. Pojedyncze left oznacza left center. Zapis right 10px bottom 20px określa odsunięcia od wskazanych krawędzi.

Procent wyrównuje punkt zawartości do odpowiadającego mu punktu pola: 100% 50% wyrównuje prawe krawędzie i środki w pionie. Dla każdej osi przesunięcie od początku wynosi (rozmiar pola - rozmiar obiektu) × procent. Przy kadrowaniu różnica może być ujemna. Jeśli rozmiary są równe, zmiana procentu w tej osi nie daje przesunięcia.

Zawartość poza polem jest przycinana; niezakryte miejsca pokazują tło elementu. W przykładzie cover zachowuje proporcje obrazu, a right center pozostawia widoczną jego niebieską połowę. Właściwość nie zastępuje background-position, które pozycjonuje obrazy tła.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>object-position</title>
<style>
  img {
    display: block;
    width: 120px;
    height: 120px;
    object-fit: cover;
    object-position: right center;
  }
</style>
<img alt="Blue square" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='240' height='120' viewBox='0 0 240 120'%3E%3Cpath fill='red' d='M0 0h120v120H0z'/%3E%3Cpath fill='blue' d='M120 0h120v120H120z'/%3E%3C/svg%3E">

Wynik

A 120 × 120 CSS-pixel blue square; the red half is clipped.

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

Źródła