CSS свойство border-image-source

Определение и применение

CSS свойство border-image-source указывает путь (относительный или абсолютный) к изображению, которое будет использовано в качестве границы. Допускается использование градиентов вместо изображения.

Если значение свойства установлено как "none" (по умолчанию), или изображение по каким-то причинам не отображается, то границы элемента будут стилизованы в соответствии со значениями определенными в свойстве border.

Попробуйте значения border-image-source

Градиент используется как изображение рамки. Срезы и ширина заданы отдельно. При none видна обычная сплошная рамка.

Значение свойства

border-image-source: linear-gradient(#245a85, #ef803c)

HTML и CSS примера
HTML
<div class="scene">
  <div class="demo-target">Градиентная рамка</div>
</div>
CSS
.scene {
  width: 100%;
  max-width: 300px;
  color: #172c3d;
  font: 16px/1.4 system-ui;
}
.source {
  display: block;
  width: 60px;
  height: 60px;
  margin: 0 auto 24px;
}
.demo-target {
  box-sizing: border-box;
  width: 100%;
  min-height: 120px;
  padding: 16px;
  border: 18px solid #245a85;
  background: #fff3d6;
  border-image-slice: 1;
  border-image-width: 1;
  border-image-repeat: stretch;
  border-image-source: linear-gradient(#245a85, #ef803c);
}

Поддержка браузерами

Спецификация: CSS backgrounds

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьcss.properties.border-image-source
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
border-image-source✓15✓12✓15✓15✓6✓18✓15✓14✓6✓1.0✓4.4✓6
none✓15✓12✓15✓15✓6✓18✓15✓14✓6✓1.0✓4.4✓6

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

CSS синтаксис:

CSS
border-image-source: none | <image>;

/* Глобальные значения */
border-image-source: initial | inherit | unset | revert | revert-layer;

| — выбор варианта.

JavaScript синтаксис:

JavaScript
element.style.borderImageSource = "url(ramka.png)";

Начальное значение свойства

none.

Значения свойства

Значения border-image-source
Значение Описание
none Изображение не будет использовано. Начальное значение.
image Указывает путь (относительный или абсолютный) к изображению, которое будет использовано в качестве границы. Допускается использование градиентов вместо изображения и встроенных SVG .
initial Устанавливает начальное значение свойства.
inherit Наследует вычисленное значение свойства у родительского элемента.
unset Для ненаследуемого свойства border-image-source устанавливает его начальное значение.
revert Отменяет заданное в коде значение свойства для этого элемента: применяются пользовательские или стандартные стили браузера. Если они не задают значение, свойство наследуется или получает начальное значение по обычным правилам. Не возвращает значение из предыдущей строки CSS.
revert-layer Сбрасывает значение свойства для текущего слоя каскада @layer. Применяется значение из другого слоя по правилам каскада; если подходящего значения нет, возможен откат к стилям пользователя или браузера.

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

CSS Backgrounds and Borders — спецификация border-image-source.

Наследуется

Нет.

Анимируемое

Тип анимации — дискретный: значение переключается без плавных промежуточных положений.

Примеры, попробуйте сами

Градиент вместо изображения

У первой рамки источник — градиент, у второй — none. Замените none другим градиентом: обычная серая граница заменится рисунком. Настройки среза и толщины остаются одинаковыми.

base.css
CSS
* {
    box-sizing: border-box;
}
body {
    margin: 16px;
    font:
        16px/1.4 system-ui,
        sans-serif;
    color: #172c3d;
}
.comparison {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(min(100%, 190px), 1fr));
    gap: 24px;
}
section {
    min-width: 0;
    padding: 16px;
}
h3 {
    margin: 0 0 24px;
    font-size: 16px;
}
.sample {
    min-height: 150px;
    padding: 28px;
    background: #f4f6f8;
}
.bounds {
    outline: 1px dashed #607589;
}
index.html
HTML
<div class="comparison">
  <section>
    <h3>Вариант A</h3>
    <div class="bounds"><div class="sample">Содержимое блока</div></div>
  </section>
  <section>
    <h3>Вариант B</h3>
    <div class="bounds"><div class="sample second">Содержимое блока</div></div>
  </section>
</div>
style.css
CSS
.sample {
    border: 12px solid #607589; /* Граница задаёт место для рисунка. */
    border-image-source: repeating-linear-gradient(45deg, #245a85 0 12px, #edc44b 12px 24px);
    border-image-slice: 24;
}
.second {
    border-image-source: none;
}