CSS свойство outline-offset

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

CSS свойство outline-offset добавляет пространство между контуром и краем элемента или его границы (при наличии).

Контур не является частью элемента и не влияет на его ширину - свойства элемента width и height не содержат ширину контура.

Попробуйте значения outline-offset

Outline рисуется поверх окружения и не занимает места в раскладке. Соседний блок остаётся на прежнем месте. Обводка здесь задана явно, без необходимости фокусировать элемент.

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

outline-offset: 0

HTML и CSS примера
HTML
<div class="stage">
  <div class="demo-target">Обводка</div>
  <div class="neighbor">Соседний блок</div>
</div>
CSS
* {
  box-sizing: border-box;
}
.stage {
  width: 100%;
  max-width: 300px;
  padding: 12px;
  border: 2px dashed #607589;
  background: #edf2f5;
  font: 16px/1.4 system-ui;
  color: #172c3d;
}
.stage {
  padding: 20px;
}
.demo-target {
  background: #ffe4bd;
  border: 3px solid #245a85;
  padding: 12px;
  outline: 4px solid #b53625;
  outline-offset: 0;
}
.neighbor {
  margin-top: 12px;
  padding: 8px;
  background: #d9edf8;
}

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

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

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

Показать браузеры
Совместимостьcss.properties.outline-offset
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
outline-offset✓1✓15✓1.5✓9.5✓1.2✓18✓4✓14✓1✓1.0✓37✓1

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

CSS синтаксис:

CSS
outline-offset: <length>;

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

JavaScript синтаксис:

JavaScript
element.style.outlineOffset = "5px";

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

0.

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

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

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

CSS Basic User Interface — спецификация outline-offset.

Наследуется

Нет.

Анимируемое

Да, по вычисленному значению: совместимые числовые значения интерполируются плавно. Переход между несовместимыми типами или ключевыми словами может быть дискретным.

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

Контур блока

Измените 8px на -4px, чтобы переместить контур внутрь блока.

base.css
CSS
* {
    box-sizing: border-box;
}
body {
    margin: 16px;
    font:
        16px/1.5 system-ui,
        sans-serif;
    color: #172c3d;
}
section {
    margin-bottom: 24px;
    min-width: 0;
}
h3 {
    margin: 0 0 12px;
    font-size: 16px;
}
.item {
    padding: 8px;
    min-width: 0;
    background: #c5dbea;
    border: 1px solid #35658a;
    overflow-wrap: anywhere;
}
.sample {
    margin: 20px;
    border: 1px solid #8495a5;
    padding: 12px;
}
index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width,initial-scale=1" />
    <title>Контур блока</title>
  </head>
  <body>
    <section>
      <h3>Вариант A</h3>
      <div class="sample first">Результат</div>
    </section>
    <section>
      <h3>Вариант B</h3>
      <div class="sample second">Результат</div>
    </section>
  </body>
</html>
style.css
CSS
.sample {
    outline: 3px solid #245a85;
}
.first {
    outline-offset: 0;
}
.second {
    outline-offset: 8px;
}