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 July 2015.

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

Die text-decoration-line CSS Eigenschaft legt die Art der Dekoration fest, die für Text in einem Element verwendet wird, wie zum Beispiel eine Unterstreichung oder Überstreichung.

Probieren Sie es aus

text-decoration-line: none;

text-decoration-line: underline;

text-decoration-line: overline;

text-decoration-line: line-through;

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 Dekorationseigenschaften auf einmal gesetzt werden sollen, ist es möglicherweise bequemer, die text-decoration Kurzform-Eigenschaft 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 eines oder mehrere aus der untenstehenden Liste durch Leerzeichen getrennte Werte angegeben.

Werte

none

Erzeugt keine Textdekoration.

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 verläuft.

Der Text blinkt (wechselt zwischen sichtbar und unsichtbar). Übereinstimmende User-Agents dürfen den Text nicht blinken lassen. Dieser Wert ist veraltet zugunsten von CSS-Animationen.

spelling-error

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

grammar-error

Jede Textzeile verwendet die Methode des User-Agents 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 in der text-decoration Kurzform (wie text-underline-position, color oder stroke).

Formale Definition

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

Formale 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 auf 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, erfolgt keine Stiländerung.

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

BCD tables only load in the browser

Siehe auch