Spec-Zone.ru › HTML

<pre>: Элемент предварительно отформатированного текста

Базовая линия Широкодоступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

Элемент <pre> HTML представляет собой предварительно отформатированный текст, который должен быть представлен точно так, как он написан в файле HTML. Текст обычно отображается с помощью непропорционального или моноширинного шрифта. Пробелы внутри этого элемента отображаются как написанные.

По умолчанию, элемент <pre> является блочным элементом, т.е. его значение по умолчанию для display равно block.

Попробуйте

Если вам необходимо отобразить зарезервированные символы, такие как <, >, &, и " внутри тега <pre>, символы необходимо экранировать, используя соответствующие символьные ссылки.

Элементы <pre> обычно содержат элементы <code>, <samp>, и <kbd>, чтобы соответственно представить компьютерный код, вывод компьютера и ввод пользователя.

Атрибуты

Этот элемент содержит только глобальные атрибуты.

width Устаревший Нестандартный

Содержит желаемое количество символов на строке. Хотя технически он всё ещё реализован, этот атрибут не оказывает визуального эффекта; для достижения такого эффекта используйте CSS width вместо него.

wrap Нестандартный Устаревший

Является подсказкой, указывающей, как должен происходить перенос строки. В современных браузерах эта подсказка игнорируется, и визуальный эффект при её наличии отсутствует; для достижения такого эффекта используйте CSS white-space вместо него.

Доступность

Важно предоставить альтернативное описание для любых изображений или диаграмм, созданных с помощью предварительно отформатированного текста. Альтернативное описание должно ясно и лаконично описывать содержимое изображения или диаграммы.

Люди с нарушениями зрения, просматривающие веб-страницы с помощью вспомогательных технологий, таких как экранный диктор, могут не понять, что представляют собой символы предварительно отформатированного текста, когда они считываются последовательно.

Комбинация элементов <figure> и <figcaption>, дополненная атрибутами ARIA role и aria-label на элементе pre позволяет объявить предварительно отформатированный графический рисунок ASCII как изображение с альтернативным текстом, а figcaption служит подписью к изображению.

Пример

html
<figure>
  <pre role="img" aria-label="ASCII COW">
      ___________________________
  &lt; I'm an expert in my field. &gt;
      ---------------------------
          \   ^__^
           \  (oo)\_______
              (__)\       )\/\
                  ||----w |
                  ||     ||
  </pre>
  <figcaption id="cow-caption">
    A cow saying, "I'm an expert in my field." The cow is illustrated using
    preformatted text characters.
  </figcaption>
</figure>
  • MDN Понимание WCAG, объяснения Руководства 1.1
  • H86: Предоставление текстовых альтернатив для графики ASCII, эмотиконов и леетспика | W3C Методики для WCAG 2.0

Примеры

Базовый пример

HTML

html
<p>Using CSS to change the font color is easy.</p>
<pre><code>
body {
  color: red;
}
</code></pre>

Результат

Экранирование зарезервированных символов

HTML

html
<pre><code>
let i = 5;

if (i &lt; 10 &amp;&amp; i &gt; 0)
  return &quot;Single Digit Number&quot;
</code></pre>

Результат

Техническое резюме

Категории содержимого Потоковое содержимое, осязаемое содержимое.
Разрешенное содержимое Разрывистое содержимое.
Пропуск тега Нет, как стартовый, так и конечный тег обязательны.
Разрешённые родительские элементы Любой элемент, принимающий потоковое содержимое.
Неявная роль ARIA generic
Разрешённые роли ARIA Любые
Интерфейс DOM HTMLPreElement

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

Спецификация
Стандарт HTML
# the-pre-element

Совместимость с браузерами

Рабочий стол Мобильный
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
pre 1 12 1 15 ≤4 18 4 14 ≤3.2 1.0 4.4
width
1Указание атрибута width не оказывает влияния на расположение.
12Указание атрибута width не оказывает влияния на расположение.
1Начиная с Firefox 29, указание атрибута width не оказывает влияния на расположение.
15Указание атрибута width не оказывает влияния на расположение.
3Указание атрибута width не оказывает влияния на расположение.
18Указание атрибута width не оказывает влияния на расположение.
4Начиная с Firefox 29, указание атрибута width не оказывает влияния на расположение.
14Указание атрибута width не оказывает влияния на расположение.
2Указание атрибута width не оказывает влияния на расположение.
1.0Указание атрибута width не оказывает влияния на расположение.
4.4Указание атрибута width не оказывает влияния на расположение.
wrap Нет Нет Нет Нет 6–16.4 Нет Нет Нет 6–16.4 Нет Нет

См. также

  • CSS: white-space, word-break
  • Символьная ссылка
  • Связанные элементы: <code>, <samp>, <kbd>

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Element/pre

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API