text-decoration-line

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

* Some parts of this feature may have varying levels of support.

Die text-decoration-line CSS Eigenschaft legt die Art der Dekoration fest, die auf Text in einem Element angewendet wird, wie z.B. eine Unterstreichung oder ein Überstrich.

Probieren Sie es aus

text-decoration-line: none;

text-decoration-line: underline;

text-decoration-line: overline;

text-decoration-line: line-through;

text-decoration-line: grammar-error;

text-decoration-line: spelling-error;

text-decoration-line: underline overline;

text-decoration-line: underline line-through;

<section id="default-example">
  <p>
    I'd far rather be
    <span class="transition-all" id="example-element">happy than right</span>
    any day.
  </p>
</section>

p {
  font: 1.5em sans-serif;
}

Wenn mehrere Zeilendekorations-Eigenschaften gleichzeitig festgelegt werden, kann es praktischer sein, die Kurzschreibweise text-decoration zu verwenden.

Syntax

css
/* Single keyword */
text-decoration-line: none;
text-decoration-line: underline;
text-decoration-line: overline;
text-decoration-line: line-through;
text-decoration-line: blink;
text-decoration-line: spelling-error;
text-decoration-line: grammar-error;

/* Multiple keywords */
text-decoration-line: underline overline; /* Two decoration lines */
text-decoration-line: overline underline line-through; /* Multiple decoration lines */

/* Global values */
text-decoration-line: inherit;
text-decoration-line: initial;
text-decoration-line: revert;
text-decoration-line: revert-layer;
text-decoration-line: unset;

Die text-decoration-line Eigenschaft wird als none oder ein oder mehrere durch Leerzeichen getrennte Werte aus der folgenden Liste angegeben.

Werte

none

Es wird keine Textdekoration erzeugt.

underline

Jede Textzeile hat eine dekorative Linie darunter.

overline

Jede Textzeile hat eine dekorative Linie darüber.

line-through

Jede Textzeile hat eine dekorative Linie, die durch die Mitte geht.

Der Text blinkt (wechselt zwischen sichtbar und unsichtbar). Entsprechende Benutzeragenten lassen den Text möglicherweise nicht blinken. Dieser Wert ist zugunsten von CSS-Animationen veraltet.

spelling-error

Jede Textzeile verwendet die Methode des Benutzeragenten zur Hervorhebung von Rechtschreibfehlern, was in den meisten Browsern eine gepunktete rote Linie ist.

grammar-error

Jede Textzeile verwendet die Methode des Benutzeragenten zur Hervorhebung von Grammatikfehlern, was in den meisten Browsern eine gepunktete grüne Linie ist.

Hinweis: Bei Verwendung der Werte spelling-error und grammar-error ignoriert der Browser die anderen Eigenschaften der Kurzschreibweise text-decoration (wie text-underline-position, color oder stroke).

Offizielle Definition

Anfangswertnone
Anwendbar aufalle Elemente. Auch anwendbar auf ::first-letter und ::first-line.
VererbtNein
Berechneter Wertwie angegeben
Animationstypdiskret

Offizielle Syntax

text-decoration-line = 
  none                                                |
  [ underline || overline || line-through || blink ]

Beispiele

Einfaches Beispiel

html
<p class="wavy">Here's some text with wavy red underline!</p>
<p class="both">This text has lines both above and below it.</p>
css
.wavy {
  text-decoration-line: underline;
  text-decoration-style: wavy;
  text-decoration-color: red;
}

.both {
  text-decoration-line: underline overline;
}

Fehlerbeispiel

In diesem Beispiel enthält der erste Absatz einen Rechtschreibfehler und verwendet das Styling des Browsers für Rechtschreibfehler an dem falsch geschriebenen Wort. Der zweite Absatz verwendet das Styling des Browsers für Grammatikfehler. In Browsern, die diese text-decoration-line Werte nicht unterstützen, gibt es keine Stiländerungen.

html
<p>This text contains a <span class="spelling">speling</span> mistake.</p>
<p class="grammar">This text contain grammatical errors.</p>
css
.spelling {
  text-decoration-line: spelling-error;
}

.grammar {
  text-decoration-line: grammar-error;
}

Spezifikationen

Specification
CSS Text Decoration Module Level 3
# text-decoration-line-property

Browser-Kompatibilität

Siehe auch