border-image-repeat

Свойство border-image-repeat позволяет управлять тем, как изображение, используемое в качестве границы элемента, будет повторяться или масштабироваться.

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

Значение по умолчанию stretch
Наследуется Нет
Применяется Ко всем элементам, за исключением тех, у кого border-collapse задан как collapse
Анимируется Нет

Синтаксис

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

Значения

stretch
Изображение рамки растягивается, чтобы заполнить всю область границы.
repeat
Изображение рамки повторяется, чтобы заполнить всю область границы.
round
Изображение рамки повторяется, чтобы заполнить всю область границы, и масштабируется, чтобы количество повторов было целым числом.
space
Изображение рамки повторяется, чтобы заполнить всю область границы, и равномерно распределяется вдоль границы.

Если указано одно значение, оно применяется ко всем четырём границам элемента. Если указаны два значения, первое применяется к верхней и нижней границам, а также к средней области, второе значение — к левой и правой границам.

Песочница

Винни-Пух был всегда не прочь немного подкрепиться, в особенности часов в одиннадцать утра, потому что в это время завтрак уже давно окончился, а обед ещё и не думал начинаться. И, конечно, он страшно обрадовался, увидев, что Кролик достаёт чашки и тарелки.
div {
  background: #fffacf;
  border: 30px solid;
  border-image: url(image/bg-image.png) 30;
  border-image-repeat: {{ playgroundValue }};
}

Пример

<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>border-image-repeat</title> <style> .frame { border: 30px solid #40c4c8; /* Параметры рамки */ padding: 20px; /* Расстояние от текста до рамки */ border-image: url(/example/image/bg-image.png) 30; /* Изображение рамки */ border-image-repeat: round repeat; /* Повторение рисунка рамки */ } </style> </head> <body> <div class="frame"> Витраж представляет собой композицию сделанную из множества цветных стекол обрамлённых проволокой и наиболее эффектно смотрится при прохождении через него солнечного или искусственного света. </div> </body> </html>

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

Объект.style.borderImageRepeat

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

CSS Backgrounds and Borders Module Level 3

Браузеры

repeat 11 12 15 15 6 72
round 11 12 30 17 9.1 12
space 11 12 56 43 9.1 50
stretch 11 12 15 15 6 72
repeat 18 79 14 9.3
round 30 15 18 9.3
space 56 50 43 9.3
stretch 18 79 14 9.3

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

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

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