border-image-source

Свойство border-image-source устанавливает исходное изображение, которое будет использоваться в качестве графической рамки элемента. В качестве исходника можно указать:

  • растровое изображение в формате JPG, PNG, WebP и др.;
  • векторное изображение в формате SVG;
  • CSS-градиент.

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

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

Синтаксис

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

Значения

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

Пример

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

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

Объект.style.borderImageSource

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

CSS Backgrounds and Borders Module Level 3

Браузеры

11 12 15 15 6 15
4.4 15 14 6

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

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

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