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

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

CSS свойство outline-width задает ширину контура элемента.

Чтобы контур был видимым, задайте outline-style, отличный от none. Порядок объявлений цвета, ширины и стиля не важен.

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

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

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

outline-width: 1px

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-width: 1px;
}
.neighbor {
  margin-top: 12px;
  padding: 8px;
  background: #d9edf8;
}

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

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

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

Показать браузеры
Совместимостьcss.properties.outline-width
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
outline-width✓1✓12✓1.5

Версия 1.5 выпущена в 2005 г.

Примечание MDN (англ.)

Before Firefox 88, an outline does not follow the shape of border-radius.

Версия 1 выпущена в 2004 г. — Удалено в 3.6; Префикс -moz-

✓7✓1.2✓18✓4

Версия 4 выпущена в 2011 г.

Примечание MDN (англ.)

Before Firefox for Android 88, an outline does not follow the shape of border-radius.

✓14✓1✓1.0✓4.4✓1
medium✓1✓12✓1✓15✓1.2✓18✓4✓14✓1✓1.0✓4.4✓1
thick✓1✓12✓1✓15✓1.2✓18✓4✓14✓1✓1.0✓4.4✓1
thin✓1✓12✓1✓15✓1.2✓18✓4✓14✓1✓1.0✓4.4✓1

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

CSS синтаксис:

CSS
outline-width: <line-width>;

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

JavaScript синтаксис:

JavaScript
element.style.outlineWidth = "thick";

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

medium.

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

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

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

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

Наследуется

Нет.

Анимируемое

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

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

Контур блока

Измените 6px на 10px: контур становится толще без смещения соседей.

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-style: solid;
    outline-color: #245a85;
}
.first {
    outline-width: 2px;
}
.second {
    outline-width: 6px;
}