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.