<pre>

Tekst sformatowany wstępnie: zachowuje spacje, tabulatory i przełamania linii dokładnie tak, jak w kodzie.

Wyświetlanie
block
Znacznik zamykający
Wymagany
Dozwolona zawartość
Treść frazowa (phrasing content)
Na tej stronie

Przykład

#
HTML
<pre><code>function greet(name) {
  return 'Cześć, ' + name + '!';
}

console.log(greet('Ola'));</code></pre>
Podgląd

Definicja i zastosowanie

#

Zwykle przeglądarka skleja kilka spacji w jedną i ignoruje przełamania linii w kodzie HTML. Element <pre> wyłącza to zachowanie: tekst wyświetla się dokładnie tak, jak wygląda w kodzie, z każdą spacją, tabulatorem i nową linią. Domyślnie używa czcionki o stałej szerokości znaków.

Najczęściej zawiera listingi kodu, wyniki poleceń z terminala, drzewa katalogów albo rysunki ze znaków ASCII. Kod programu umieszczaj w parze <pre><code>…</code></pre>: <pre> dba o formatowanie, a <code> mówi, że to kod.

Znaki < i & nadal mają w środku specjalne znaczenie, więc zapisuj je jako &lt; i &amp;. Długie linie nie zawijają się same i mogą wystawać poza kontener, dlatego zwykle dodaje się overflow-x: auto. Pojedyncze przełamanie linii tuż po znaczniku otwierającym parser pomija, więc treść możesz spokojnie zacząć od nowej linii.

Składnia

#
Składnia
<pre>
tekst,   który   zachowa
    wszystkie odstępy
</pre>

Atrybuty

#

Ten element nie ma własnych atrybutów. Obsługuje atrybuty globalne, takie jak class, id czy hidden.

Więcej przykładów

#
Struktura katalogów projektu
HTML
<pre>
moja-strona/
├── index.html
├── css/
│   └── style.css
└── js/
    └── app.js
</pre>
Podgląd
Znaki specjalne w bloku kodu
HTML
<pre><code>&lt;a href="/kursy"&gt;Kursy &amp; ścieżki&lt;/a&gt;</code></pre>
Podgląd

W kodzie źródłowym stoją encje, a w podglądzie widać zwykłe znaki <, > i &.

Domyślny CSS

#

Większość przeglądarek wyświetla ten element z takimi stylami domyślnymi:

CSS
pre {
  display: block;
  font-family: monospace;
  white-space: pre;
  margin-block: 1em;
}

Obsługa przeglądarek

#

Szeroko dostępne

Działa we wszystkich nowoczesnych przeglądarkach, także na telefonach. Możesz używać bez obaw.

  • Chrome
  • Edge
  • Firefox
  • Safari

Dobre praktyki

#
  • Blok kodu zapisuj jako <pre><code>, a krótki fragment w zdaniu jako samo <code>.
  • Dodaj overflow-x: auto, żeby długie linie przewijały się w poziomie, zamiast rozpychać stronę na telefonie.
  • Rysunek ze znaków ASCII umieść w <figure> z opisem w <figcaption>, bo czytnik ekranu odczyta go jako ciąg przypadkowych symboli.

Powiązane hasła

#

Widzisz błąd albo brakuje przykładu? Napisz do nas.