background-image

Краткое описание

Свойство CSS background-image устанавливает одно или несколько фоновых изображений для элемента. Изображения рисуются в слоях контекстов наложения одно поверх другого. Первый слой выводится так, чтобы он был ближе всего к пользователю.

Границы border элемента затем рисуются поверх них, и background-color рисуется под ними. То, как изображения отрисовываются относительно рамки и её границ, определяется CSS-свойствами background-clip и background-origin.

Если указанное изображение не может быть нарисовано (например, когда файл, определённый указанным URI, не может быть загружен), браузеры обрабатывают его так, как если бы оно было значением none.

Обратите внимание: Даже, если изображение непрозрачно и цвет не будет показан при нормальных обстоятельствах, веб-разработчику следует всегда указывать атрибут background-color. Если изображение не может быть загружено —например, в случае отказа сетевого подключения — у элемента будет отображён цветной фон.

Начальное значение	`none`
Применяется к	все элементы. Это также применяется к `::first-letter` и `::first-line`.
Наследуется	нет
Обработка значения	как указано, но с абсолютными значениями `url`
Animation type	discrete

Синтаксис

background-image: none;
background-image: url(http://www.example.com/bck.png);

background-image: inherit;

Значения

none: Это ключевое слово обозначает отсутствие изображений.
<image>: <image> (en-US) обозначает изображение для отображения. Их может быть несколько, разделённых запятыми, поскольку поддерживается несколько фонов (en-US).

Официальный синтаксис

background-image = 
  <bg-image># (en-US)  

<bg-image> = 
  <image>  | (en-US)
  none     

<image> = 
  <url>           | (en-US)
  <image()>       | (en-US)
  <image-set()>   | (en-US)
  <cross-fade()>  | (en-US)
  <element()>     | (en-US)
  <gradient>      

<image()> = 
  image( <image-tags>? (en-US) [ (en-US) <image-src>? (en-US) , <color>? (en-US) ]! )  

<image-set()> = 
  image-set( <image-set-option># (en-US) )  

<cross-fade()> = 
  cross-fade( <cf-image># (en-US) )  

<element()> = 
  element( <id-selector> )  

<gradient> = 
  <linear-gradient()>            | (en-US)
  <repeating-linear-gradient()> (en-US)  | (en-US)
  <radial-gradient()>            | (en-US)
  <repeating-radial-gradient()> (en-US)  

<image-tags> = 
  ltr  | (en-US)
  rtl  

<image-src> = 
  <url>     | (en-US)
  <string> (en-US)  

<color> = 
  <absolute-color-base>  | (en-US)
  currentcolor           | (en-US)
  <system-color>         | (en-US)
  <device-cmyk()>        

<image-set-option> = 
  [ (en-US) <image> | (en-US) <string> (en-US) ] (en-US) [ (en-US) <resolution> (en-US) || (en-US) type( <string> (en-US) ) ] (en-US)  

<cf-image> = 
  <percentage>? (en-US)          && (en-US)
  [ (en-US) <image> | (en-US) <color> ] (en-US)  

<id-selector> = 
  <hash-token>  

<linear-gradient()> = 
  linear-gradient( [ (en-US) <angle> | (en-US) to <side-or-corner> ] (en-US)? (en-US) , <color-stop-list> )  

<radial-gradient()> = 
  radial-gradient( [ (en-US) <ending-shape> || (en-US) <size> ] (en-US)? (en-US) [ (en-US) at <position> ] (en-US)? (en-US) , <color-stop-list> )  

<absolute-color-base> = 
  <hex-color> (en-US)    | (en-US)
  <named-color>  | (en-US)
  transparent    | (en-US)
  <rgb()>        | (en-US)
  <rgba()>       | (en-US)
  <hsl()>        | (en-US)
  <hsla()>       | (en-US)
  <hwb()>        | (en-US)
  <lab()>        | (en-US)
  <lch()>        | (en-US)
  <oklab()>      | (en-US)
  <oklch()>      | (en-US)
  <color()>      

<device-cmyk()> = 
  device-cmyk( <cmyk-component>{4} (en-US) [ (en-US) / <alpha-value> ] (en-US)? (en-US) )  

<side-or-corner> = 
  [ (en-US) left | (en-US) right ] (en-US)  || (en-US)
  [ (en-US) top | (en-US) bottom ] (en-US)  

<color-stop-list> = 
  <linear-color-stop> , [ (en-US) <linear-color-hint>? (en-US) , <linear-color-stop> ] (en-US)# (en-US)  

<position> = 
  [ (en-US) left | (en-US) center | (en-US) right | (en-US) top | (en-US) bottom | (en-US) start | (en-US) end | (en-US) <length-percentage> ] (en-US)  | (en-US)
  [ (en-US) left | (en-US) center | (en-US) right | (en-US) x-start | (en-US) x-end | (en-US) <length-percentage> ] (en-US) [ (en-US) top | (en-US) center | (en-US) bottom | (en-US) y-start | (en-US) y-end | (en-US) <length-percentage> ] (en-US)  | (en-US)
  [ (en-US) center | (en-US) [ (en-US) left | (en-US) right | (en-US) x-start | (en-US) x-end ] (en-US) <length-percentage>? (en-US) ] (en-US) && (en-US) [ (en-US) center | (en-US) [ (en-US) top | (en-US) bottom | (en-US) y-start | (en-US) y-end ] (en-US) <length-percentage>? (en-US) ] (en-US)  | (en-US)
  [ (en-US) center | (en-US) [ (en-US) start | (en-US) end ] (en-US) <length-percentage>? (en-US) ] (en-US) [ (en-US) center | (en-US) [ (en-US) start | (en-US) end ] (en-US) <length-percentage>? (en-US) ] (en-US)  

<rgb()> = 
  rgb( [ (en-US) <percentage> | (en-US) none ] (en-US){3} (en-US) [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )  | (en-US)
  rgb( [ (en-US) <number> | (en-US) none ] (en-US){3} (en-US) [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )  

<hsl()> = 
  hsl( [ (en-US) <hue> | (en-US) none ] (en-US) [ (en-US) <percentage> | (en-US) none ] (en-US) [ (en-US) <percentage> | (en-US) none ] (en-US) [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )  

<hwb()> = 
  hwb( [ (en-US) <hue> | (en-US) none ] (en-US) [ (en-US) <percentage> | (en-US) none ] (en-US) [ (en-US) <percentage> | (en-US) none ] (en-US) [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )  

<lab()> = 
  lab( [ (en-US) <percentage> | (en-US) <number> | (en-US) none ] (en-US) [ (en-US) <percentage> | (en-US) <number> | (en-US) none ] (en-US) [ (en-US) <percentage> | (en-US) <number> | (en-US) none ] (en-US) [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )  

<lch()> = 
  lch( [ (en-US) <percentage> | (en-US) <number> | (en-US) none ] (en-US) [ (en-US) <percentage> | (en-US) <number> | (en-US) none ] (en-US) [ (en-US) <hue> | (en-US) none ] (en-US) [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )  

<oklab()> = 
  oklab( [ (en-US) <percentage> | (en-US) <number> | (en-US) none ] (en-US) [ (en-US) <percentage> | (en-US) <number> | (en-US) none ] (en-US) [ (en-US) <percentage> | (en-US) <number> | (en-US) none ] (en-US) [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )  

<oklch()> = 
  oklch( [ (en-US) <percentage> | (en-US) <number> | (en-US) none ] (en-US) [ (en-US) <percentage> | (en-US) <number> | (en-US) none ] (en-US) [ (en-US) <hue> | (en-US) none ] (en-US) [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )  

<color()> = 
  color( <colorspace-params> [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )  

<cmyk-component> = 
  <number>      | (en-US)
  <percentage>  

<alpha-value> = 
  <number>      | (en-US)
  <percentage>  

<linear-color-stop> = 
  <color>               && (en-US)
  <length-percentage>? (en-US)  

<linear-color-hint> = 
  <length-percentage>  

<length-percentage> = 
  <length>      | (en-US)
  <percentage>  

<hue> = 
  <number>  | (en-US)
  <angle>   | (en-US)
  none      

<colorspace-params> = 
  <predefined-rgb-params>  | (en-US)
  <xyz-params>             

<predefined-rgb-params> = 
  <predefined-rgb> [ (en-US) <number> | (en-US) <percentage> | (en-US) none ] (en-US){3} (en-US)  

<xyz-params> = 
  <xyz-space> [ (en-US) <number> | (en-US) none ] (en-US){3} (en-US)  

<predefined-rgb> = 
  srgb          | (en-US)
  srgb-linear   | (en-US)
  display-p3    | (en-US)
  a98-rgb       | (en-US)
  prophoto-rgb  | (en-US)
  rec2020       

<xyz-space> = 
  xyz      | (en-US)
  xyz-d50  | (en-US)
  xyz-d65

Примеры

Несколько фонов и прозрачность

Обратите внимание, что изображение звезды частично прозрачно и наложено на изображение кошки.

HTML содержимое

<div>
    <p class="catsandstars">
        This paragraph is full of cats<br />and stars.
    </p>
    <p>This paragraph is not.</p>
    <p class="catsandstars">
        Here are more cats for you.<br />Look at them!
    </p>
    <p>And no more.</p>
</div>

CSS содержимое

pre, p {
    font-size: 1.5em;
    color: #FE7F88;
    background-color: transparent;
}

div {
  background-image: url("https://mdn.mozillademos.org/files/6457/mdn_logo_only_color.png");
}

p {
  background-image: none;
}

.catsandstars {
  background-image:  url("https://mdn.mozillademos.org/files/11991/startransparent.gif"),
                     url("https://mdn.mozillademos.org/files/7693/catfront.png");
  background-color: transparent;
}

Спецификации

Specification
CSS Backgrounds and Borders Module Level 4 # background-image

Совместимость браузеров

BCD tables only load in the browser

Смотрите также

CSS спрайты изображений (en-US)
<img>
Статьи, связанные с изображениями:: <image> (en-US), linear-gradient (en-US), radial-gradient (en-US), repeating-linear-gradient (en-US), repeating-radial-gradient (en-US), element (en-US).