---
title: "`text-box`"
description: "Шорткат, который управляет обрезкой вертикального пространства текста и его выравниванием по типографским линиям."
url: "https://doka.guide/css/text-box/"
section: "CSS"
createdAt: "2025-10-07"
updatedAt: "2025-10-07"
baseline: [{"group":"text-box","features":["css.properties.text-box","css.properties.text-box-edge","css.properties.text-box-edge.auto","css.properties.text-box-trim","css.properties.text-box-trim.none","css.properties.text-box-trim.trim-both","css.properties.text-box-trim.trim-end","css.properties.text-box-trim.trim-start","css.properties.text-box.normal","css.types.text-edge","css.types.text-edge.alphabetic","css.types.text-edge.cap","css.types.text-edge.ex","css.types.text-edge.text"]}]
authors: ["drakesbot12"]
related: ["css/text-box-trim", "css/text-box-edge", "css/line-height"]
source: "https://github.com/doka-guide/content/blob/main/css/text-box/index.md"
license: "CC BY-NC-SA 4.0"
---

# `text-box`

## Кратко

Свойство `text-box` является шорткатом и объединяет в себе [`text-box-trim`](/css/text-box-trim/) и [`text-box-edge`](/css/text-box-edge/). Оно позволяет обрезать лишнее вертикальное пространство над и под текстом, подгоняя его под важные линии шрифта: верхушки заглавных букв (`cap`), высоту строчных (`ex`), базовую линию (`alphabetic`) и другие.

## Пример

```css
.one {
  text-box: trim-end cap alphabetic;
}

.two {
  text-box: trim-both ex alphabetic;
}
```

<iframe title="Два параграфа с разной обрезкой text-box" src="https://doka.guide/css/text-box/demos/basic/" height="180"></iframe>

## Как пишется

```css
.something {
  text-box: text-box-trim text-box-edge;
}
```

Свойство `text-box` — это шорткат, который объединяет два свойства:

- [`text-box-trim`](/css/text-box-trim/) — указывает, какие края текстового блока обрезать: сверху (`trim-start`), снизу (`trim-end`) или оба сразу (`trim-both`);
- [`text-box-edge`](/css/text-box-edge/) — указывает, по каким линиям шрифта происходит обрезка: например, по верхней границе заглавных букв (`cap`), по x-высоте — верхнему краю строчных букв вроде **x**, **n**, **o** (`ex`), по базовой линии (`alphabetic`) или по умолчанию ничего не обрезать (`text`).

### Значения `text-box-trim`

- `none` — не обрезать;
- `trim-start` — обрезать только верхний край;
- `trim-end` — обрезать только нижний край;
- `trim-both` — обрезать оба края (значение по умолчанию).

### Значения `text-box-edge`

Можно указать один или два ориентира.

Один ориентир (применяется к обоим краям):

```css
.something {
  text-box: trim-both cap;
}
```

Два ориентира (первое — для верхнего края, второе — для нижнего):

```css
.something {
  text-box: trim-both cap alphabetic;
}
```

Возможные ориентиры:

- `cap` — верх заглавных букв;
- `ex` — верх строчной буквы `x`;
- `alphabetic` — базовая линия;
- `ideographic`— линия, по которой выравниваются иероглифы в азиатских шрифтах.
- `ideographic-ink` — то же, что `ideographic`, но с учётом чернил, выходящих за пределы символа.
- `auto` — выбор браузера (по умолчанию).

## Как понять

Когда браузер отрисовывает текст, он добавляет вертикальные отступы сверху и снизу строки. Эти отступы зависят от шрифта и включают:

- подступы для восходящих элементов (б, й, ё);
- подступы для нисходящих (у, р, ц);
- внутренние отступы шрифта (называются `leading`).

Восходящие элементы — это части букв, выходящие выше основной части строки (например, б, й, ё), а нисходящие — те, что опускаются ниже базовой линии (у, р, ц).

Из-за этого текст может выглядеть как будто «висит» в блоке, а фон или рамка оказываются не выровнены по буквам. Свойство `text-box` позволяет убрать эти лишние отступы и сделать так, чтобы:

- верхний край блока совпадал, например, с верхушками заглавных букв (`cap`);
- нижний край — с базовой линией (`alphabetic`) или высотой строчных (`ex`).

<aside>

📐 Это особенно полезно, когда выравнивание важно — например, в кнопках, карточках, сайдбарах. Вместо хаотичных отступов вы получаете точное выравнивание текста по визуальным ориентирам шрифта.

</aside>

<iframe title="Интерактивная демка text-box" src="https://doka.guide/css/text-box/demos/practice/" height="500"></iframe>

## Подсказки

💡 Поддержка свойства указана на [Can I Use](https://caniuse.com/mdn-css_properties_text-box).

💡 Вместо использования [`border`](/css/border/) для визуализации эффекта, вы можете использовать свойство [`outline`](/css/outline/). Оно не влияет на размеры элемента и не увеличивает высоту строки, в отличие от [`border`](/css/border/).

💡 Часто используемое значение шортката `trim-both cap alphabetic` убирает ненужные воздушные карманы сверху и снизу.

💡 Лучше всего работает в комбинации с [`line-height`](/css/line-height/), когда нужен плотный вертикальный ритм в дизайне.

