background-origin

Свойство background-origin определяет область позиционирования фонового рисунка. Это свойство не применяется, когда значение background-attachment задано как fixed.

Краткая информация

Значение по умолчанию padding-box
Наследуется Нет
Применяется Ко всем элементам
Анимируется Нет

Синтаксис

background-origin: [padding-box | border-box | content-box] 
  [, [padding-box | border-box | content-box]]*
Описание Пример
<тип> Указывает тип значения. <размер>
A && B Значения должны выводиться в указанном порядке. <размер> && <цвет>
A | B Указывает, что надо выбрать только одно значение из предложенных (A или B). normal | small-caps
A || B Каждое значение может использоваться самостоятельно или совместно с другими в произвольном порядке. width || count
[ ] Группирует значения. [ crop || cross ]
* Повторять ноль или больше раз. [,<время>]*
+ Повторять один или больше раз. <число>+
? Указанный тип, слово или группа не является обязательным. inset?
{A, B} Повторять не менее A, но не более B раз. <радиус>{1,4}
# Повторять один или больше раз через запятую. <время>#

Значения

padding-box
Фон позиционируется относительно края элемента с учетом толщины границы.
border-box
Фон позиционируется относительно границы, при этом линия границы может перекрывать изображение.
content-box
Фон позиционируется относительно содержимого элемента.

Значений может быть несколько (для каждого из множественных фоновых рисунков), при этом значения разделяются между собой запятой.

Результат использования значений свойства background-origin для элемента с рамкой толщиной 20 пикселей показан на рис. 1.

Рис. 1а Рис. 1а Рис. 1а
padding-box border-box content-box

Рис. 1. Результат применения разных значений

Песочница

div {
  border: 5px dashed #c26558;
  padding: 20px;
  background-origin: {{ playgroundValue }};
}

Пример

<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>background-origin</title> <style> .example { border: 20px solid #fc0; padding: 20px; height: 200px; background: url(/example/image/figure.jpg) no-repeat; background-origin: content-box; } </style> </head> <body> <div class="example">...</div> </body> </html>

Объектная модель

Объект.style.backgroundOrigin

Примечание

Если фон задан один, а значений background-origin несколько, то браузеры покажут разное поведение. Firefox и Opera используют первое значение, Chrome и Safari создадут несколько фоновых рисунков.

Safari до версии 5, Android до версии 3 поддерживают свойство -webkit-background-origin.

Opera до версии 10.5 поддерживает свойство -o-background-origin.

Firefox до версии 4 поддерживает свойство -moz-background-origin.

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

Спецификация Статус
CSS Backgrounds and Borders Module Level 3 Возможная рекомендация

Браузеры

9 12 1 10.1 10.5 3.1 5 3.6 4
2.1 3 3.6 4 10.5 3.2 5

В таблице браузеров применяются следующие обозначения.

  • — элемент полностью поддерживается браузером;
  • — элемент браузером не воспринимается и игнорируется;
  • — при работе возможно появление различных ошибок, либо элемент поддерживается с оговорками.

Число указывает версию браузреа, начиная с которой элемент поддерживается.