Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

text-indent — wcięcie tekstu

text-indent ustala wcięcie pierwszego sformatowanego wiersza tekstu. Nie przesuwa całego bloku jak margines ani nie dodaje odstępu do każdego wiersza jak padding.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

text-indent: <length-percentage> && hanging? && each-line?;

text-indent działa na kontenery blokowe i domyślnie wcina tylko pierwszy sformatowany wiersz. Wcięcie jest stosowane przy logicznej krawędzi początkowej wiersza (inline-start). O tym, której fizycznej krawędzi ona odpowiada, decydują kierunek wiersza w osi liniowej i tryb pisania, a nie kierunek poszczególnych fragmentów tekstu. Na przykład w poziomym akapicie o kierunku od prawej do lewej wcięcie jest po prawej stronie, nawet jeśli tekst jest po angielsku. Wartość początkowa wynosi 0; właściwość jest dziedziczona.

Podaj długość, np. 2em, albo procent wewnętrznego rozmiaru kontenera w osi liniowej. Wartości ujemne są dozwolone i mogą powodować wystawanie tekstu poza blok. W składni długość lub procent są obowiązkowe; opcjonalne słowa kluczowe można podać w dowolnej kolejności.

each-line obejmuje pierwszy wiersz oraz wiersze po wymuszonym podziale, ale nie po automatycznym zawinięciu. hanging odwraca wybór wierszy. Razem wcinają kontynuacje po automatycznym zawinięciu, pozostawiając bez wcięcia pierwszy wiersz i wiersze po wymuszonym podziale. Definicja w specyfikacji nie potwierdza obsługi w docelowej przeglądarce.

Przykład używa wyłącznie 32px: oczekiwane przesunięcie Alpha wynosi 32px, a Beta — 0px. Wymuszony podział nie rozpoczyna domyślnie nowego wcięcia. Przykład wymaga lokalnej weryfikacji.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>text-indent</title>
<style>
  p {
    margin: 0;
    padding: 0;
    border: 1px solid;
    width: 320px;
    font: 16px/24px monospace;
    direction: ltr;
    text-align: start;
    text-indent: 32px;
  }
</style>
<p><span id="first">Alpha</span><br><span id="second">Beta</span></p>

Wynik

Alpha: 32px inline-start offset; Beta: 0px inline-start offset, measured from the paragraph content edge.

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła