CSS свойство overflow-wrap

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

CSS свойство overflow-wrap указывает браузеру, переносить или нет длинные слова, которые не помещаются по ширине в заданную область (разрешается ли разрывать строки внутри слов).

Для нового кода используйте overflow-wrap. Старое имя word-wrap сохраняется как совместимый псевдоним. Свойство помогает размещать длинные адреса и идентификаторы в узких карточках.

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

Длинное слово не содержит пробелов. Свойство разрешает разрыв, когда оно не помещается. word-wrap — прежнее имя overflow-wrap.

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

overflow-wrap: normal

HTML и CSS примера
HTML
<div class="demo-target">ОченьДлинноеСловоБезПробеловДляПроверкиПереносов</div>
CSS
.demo-target {
  box-sizing: border-box;
  width: 100%;
  max-width: 300px;
  padding: 16px;
  border: 2px solid #245a85;
  background: #fff3d6;
  color: #172c3d;
  font: 18px/1.5 system-ui;
  overflow: auto;
  overflow-wrap: normal;
}

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

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

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

Показать браузеры
Совместимостьcss.properties.overflow-wrap
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
overflow-wrap✓23✓18✓49✓12.1✓7✓25✓49✓12.1✓7✓1.5✓4.4✓7
anywhere✓80✓80✓65✓67✓15.4✓80✓65✓57✓15.4✓13.0✓80✓15.4
break-word✓1✓12✓3.5✓10.5✓1✓18✓4✓11✓1✓1.0✓4.4✓1
normal✓1✓12✓3.5✓15✓1✓18✓4✓14✓1✓1.0✓4.4✓1

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

CSS синтаксис:

CSS
overflow-wrap: normal | break-word | anywhere;

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

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

JavaScript синтаксис:

JavaScript
element.style.overflowWrap = "normal";

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

normal.

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

Значения overflow-wrap
Значение Описание
normal Допускается переносить слова только в допустимых точках. Начальное значение.
break-word Указывает, что слово может быть прервано в произвольном месте, если нет допустимой точки для разрыва.
anywhere Разрешает разрыв длинной неразрывной последовательности в любом месте. В отличие от break-word, эти возможности переноса учитываются при вычислении min-content.
initial Устанавливает начальное значение свойства.
inherit Наследует вычисленное значение свойства у родительского элемента.
unset Для наследуемого свойства overflow-wrap наследует вычисленное значение у родительского элемента.
revert Отменяет заданное в коде значение свойства для этого элемента: применяются пользовательские или стандартные стили браузера. Если они не задают значение, свойство наследуется или получает начальное значение по обычным правилам. Не возвращает значение из предыдущей строки CSS.
revert-layer Сбрасывает значение свойства для текущего слоя каскада @layer. Применяется значение из другого слоя по правилам каскада; если подходящего значения нет, возможен откат к стилям пользователя или браузера.

Различие anywhere и break-word заметно при расчёте минимальной ширины: сравните карточки с min-content. Переносы должны быть разрешены свойством white-space; при nowrap слово не разобьётся.

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

CSS Text — спецификация overflow-wrap.

Наследуется

Да.

Анимируемое

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

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

Перенос длинного слова

Сравните длинное слово. Измените значение второго варианта и посмотрите, где браузер разрешает перенос.

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-bottom: 16px;
}

.sample {
    overflow: auto;
}
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 {
    width: 160px;
    max-width: 100%;
}
.first {
    overflow-wrap: normal;
}
.second {
    overflow-wrap: break-word;
}

Почему anywhere помогает узкой карточке

Обе карточки имеют width: min-content. В A длинное слово определяет минимальную ширину, в B anywhere разрешает уменьшить её до одного символа. Замените anywhere на break-word: минимальная ширина снова вырастет. Для обычной карточки вместо min-content задайте 180px.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Почему anywhere помогает узкой карточке</title>
  </head>
  <body>
    <h3>A</h3>
    <div class="card first">ОченьДлинныйИдентификатор</div>
    <h3>B</h3>
    <div class="card second">ОченьДлинныйИдентификатор</div>
  </body>
</html>
style.css
CSS
.card {
    width: min-content;
    border: 2px solid;
    font: 18px monospace;
}
.first {
    overflow-wrap: break-word;
}
.second {
    overflow-wrap: anywhere;
}