background-size

Właściwość background-size określa wielkość elementu background-image. Obrazek może pozostać w jego domyślnych wymiarach, rozciągnięty do nowych wymiarów lub ustawiony tak, aby zajmował całą dostępną przestrzeń zachowując swoje proporcje.

Źródło tego interaktywnego przykładu jest zlokalizowane na GitHub. Jeśli chcesz wspierać projekt interaktywnych przykładów sklonuj (clone) https://github.com/mdn/interactive-examples i wyślij nam pull request.

Przestrzenie nie zapełnione przez background-image wypełnia background-color, background-color będzie widoczny jeżeli obrazek jest przezroczysty.

Syntax

/* Wartości słowne */
background-size: cover;
background-size: contain;

/* Właściwości z jedną wartością */
/* szerokość obrazka (wysokość stanie się 'auto') */
background-size: 50%;
background-size: 3.2em;
background-size: 12px;
background-size: auto;

/* Właściwości z dwoma wartościami */
/* pierwsza wartość: szerokość obrazka, druga wartość: wysokość */
background-size: 50% auto;
background-size: 3em 25%;
background-size: auto 6px;
background-size: auto auto;

/* Wiele teł */
background-size: auto, auto; /* Not to be confused with `auto auto` */
background-size: 50%, 25%, 25%;
background-size: 6px, auto, contain;

/* Wartości globalne */
background-size: inherit;
background-size: initial;
background-size: unset;

Właściwość background-size jest określana w jeden z podanych sposobów:

• Używając wartości słownych contain lub cover.
• Używając tylko wartości długości, w tym przypadku wysokość jest domyślnie ustawiona na auto.
• Używając obu wartości (width i height), każda z wartości może być określona jako długość <length>, w procentach <percentage> lub auto.

Aby określić wielkość wielu teł, odziel wartości dla każdego tła przecinkami.

Values

contain

Skaluje obrazek do jak największych rozmiarów, bez jego rozciągania czy przycinania.

cover

Skaluje obrazek do jak największych rozmiarów, bez jego rozciągania. Jeżeli proporcje obrazu są inne od elementu, jest on przycinany pionowo lub poziomo - tak, żeby nie zostało puste miejsce.

auto

Skaluje tło w odpowiednim kierunku, po to aby zachować jego nieodłączne proporcje.

<length>

Rozciąga obrazek w odpowiednim kierunku do określonej długości. Nie można używać wartości ujemnych.

<percentage>

[do przetłumaczenia na: Polski]

Stretches the image in the corresponding dimension to the specified percentage of the background positioning area. The background positioning area is determined by the value of background-origin (by default, the padding box). However, if the background's background-attachment value is fixed, the positioning area is instead the entire viewport. Negative values are not allowed.

Intrinsic dimensions and proportions

The computation of values depends on the image's intrinsic dimensions (width and height) and intrinsic proportions (width-to-height ratio). These attributes are as follows:

• A bitmap image (such as JPG) always has intrinsic dimensions and proportions.
• A vector image (such as SVG) does not necessarily have intrinsic dimensions. If it has both horizontal and vertical intrinsic dimensions, it also has intrinsic proportions. If it has no dimensions or only one dimension, it may or may not have proportions.
• CSS <gradient>s have no intrinsic dimensions or intrinsic proportions.
• Background images created with the element() function use the intrinsic dimensions and proportions of the generating element.

Based on the intrinsic dimensions and proportions, the rendered size of the background image is computed as follows:

If both components of background-size are specified and are not auto:

The background image is rendered at the specified size.

If the background-size is contain or cover:

While preserving its intrinsic proportions, the image is rendered at the largest size contained within, or covering, the background positioning area. If the image has no intrinsic proportions, then it's rendered at the size of the background positioning area.

If the background-size is auto or auto auto:

• If the image has both horizontal and vertical intrinsic dimensions, it's rendered at that size.
• If the image has no intrinsic dimensions and has no intrinsic proportions, it's rendered at the size of the background positioning area.
• If the image has no intrinsic dimensions but has intrinsic proportions, it's rendered as if contain had been specified instead.
• If the image has only one intrinsic dimension and has intrinsic proportions, it's rendered at the size corresponding to that one dimension. The other dimension is computed using the specified dimension and the intrinsic proportions.
• If the image has only one intrinsic dimension but has no intrinsic proportions, it's rendered using the specified dimension and the other dimension of the background positioning area.

Note: SVG images have a preserveAspectRatio attribute that defaults to the equivalent of contain. In Firefox 43, as opposed to Chrome 52, an explicit background-size causes preserveAspectRatio to be ignored.

If the background-size has one auto component and one non-auto component:

• If the image has intrinsic proportions, it's stretched to the specified dimension. The unspecified dimension is computed using the specified dimension and the intrinsic proportions.
• If the image has no intrinsic proportions, it's stretched to the specified dimension. The unspecified dimension is computed using the image's corresponding intrinsic dimension, if there is one. If there is no such intrinsic dimension, it becomes the corresponding dimension of the background positioning area.

Formal syntax

<bg-size>#
where 
<bg-size> = [ <length-percentage> | auto ]{1,2} | cover | contain
where 
<length-percentage> = <length> | <percentage>

Examples

Please see Scaling background images for examples.

Notes

If you use a <gradient> as the background and specify a background-size to go with it, it's best not to specify a size that uses a single auto component, or is specified using only a width value (for example, background-size: 50%). Rendering of <gradient>s in such cases changed in Firefox 8, and at present is generally inconsistent across browsers, which do not all implement rendering in full accordance with the CSS3 background-size specification and with the CSS3 Image Values gradient specification.

.gradient-example {
  width: 50px;
  height: 100px;
  background-image: linear-gradient(blue, red);

  /* Not safe to use */
  background-size: 25px;
  background-size: 50%;
  background-size: auto 50px;
  background-size: auto 50%;

  /* Safe to use */
  background-size: 25px 50px;
  background-size: 50% 50%;
}

Note that it's particularly not recommended to use a pixel dimension and an auto dimension with a <gradient>, because it's impossible to replicate rendering in versions of Firefox prior to 8, and in browsers not implementing Firefox 8's rendering, without knowing the exact size of the element whose background is being specified.

Specifications

Browser compatibility

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

See also

• Scaling background images
• Scaling of SVG backgrounds
• object-fit