text-underline-position CSS property

Probieren Sie es aus

text-underline-position: auto;

text-underline-position: under;

<section id="default-example">
  <p>
    <span class="transition-all" id="example-element"
      >C<sub>8</sub>H<sub>10</sub>N<sub>4</sub>O<sub>2</sub></span
    >
    is the chemical formula for caffeine.
  </p>
</section>

p {
  font: 1.5em sans-serif;
}

#example-element {
  text-decoration-line: underline;
}

Syntax

/* Single keyword */
text-underline-position: auto;
text-underline-position: under;
text-underline-position: left;
text-underline-position: right;

/* Multiple keywords */
text-underline-position: under left;
text-underline-position: right under;

/* Global values */
text-underline-position: inherit;
text-underline-position: initial;
text-underline-position: revert;
text-underline-position: revert-layer;
text-underline-position: unset;

Werte

Diese Eigenschaft wird mit einem der folgenden Schlüsselwortwerte angegeben:

auto

Der User-Agent verwendet seinen eigenen Algorithmus, um die Linie auf oder unter der alphabetischen Grundlinie zu setzen.

from-font

Wenn die Schriftart-Datei Informationen über eine bevorzugte Position enthält, wird dieser Wert verwendet. Falls nicht, verhält sich die Eigenschaft so, als wäre auto gesetzt, wobei der Browser eine passende Position wählt.

under

Erzwingt, dass die Linie unterhalb der alphabetischen Grundlinie gesetzt wird, an einer Position, wo sie keine Unterlängen kreuzt. Dies ist nützlich, um die Lesbarkeit bei chemischen und mathematischen Formeln zu gewährleisten, die häufig tiefgestellte Zeichen verwenden.

left

In vertikalen Schreibmodi erzwingt dieses Schlüsselwort, dass die Linie auf der linken Seite des Textes platziert wird. In horizontalen Schreibmodi ist es ein Synonym für auto.

right

In vertikalen Schreibmodi erzwingt dieses Schlüsselwort, dass die Linie auf der rechten Seite des Textes platziert wird. In horizontalen Schreibmodi ist es ein Synonym für auto.

Formale Definition

Formale Syntax

text-underline-position = 
  auto                                       |
  [ from-font | under ] || [ left | right ]  

Beispiele

Ein einfaches Beispiel

Wir erstellen zwei Beispielabsätze:

<p class="horizontal">
  Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam consectetur ac
  turpis vel laoreet. Nullam volutpat pharetra lorem, sit amet feugiat tortor
  volutpat quis. Nam eget sodales quam. Aliquam accumsan tellus ac erat posuere.
</p>

<p class="vertical">
  Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam consectetur ac
  turpis vel laoreet. Nullam volutpat pharetra lorem, sit amet feugiat tortor
  volutpat quis. Nam eget sodales quam. Aliquam accumsan tellus ac erat posuere.
</p>

Unser CSS sieht so aus:

p {
  font-size: 1.5rem;
  text-transform: capitalize;
  text-decoration: underline;
  text-decoration-thickness: 2px;
}

.horizontal {
  text-underline-position: under;
}

.vertical {
  writing-mode: vertical-rl;
  text-underline-position: left;
}

In diesem Beispiel setzen wir beide Absätze darauf, eine dicke Unterstreichung zu haben. Im horizontalen Text verwenden wir text-underline-position: under;, um die Unterstreichung unter alle Unterlängen zu setzen.

Im Text mit einem vertikalen writing-mode können wir dann die Werte left oder right verwenden, um die Unterstreichung nach Bedarf links oder rechts vom Text erscheinen zu lassen.

Das Live-Beispiel sieht so aus:

Globale Einstellung von text-underline-position

Da die Eigenschaft text-underline-position erbt und nicht durch die Kurzschreibweise text-decoration zurückgesetzt wird, kann es sinnvoll sein, ihren Wert auf globaler Ebene festzulegen. Zum Beispiel kann der under-Wert für ein Dokument mit vielen chemischen und mathematischen Formeln geeignet sein, die häufig tiefgestellte Zeichen verwenden.

:root {
  text-underline-position: under;
}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Die text-decoration-Eigenschaft ist eine Kurzschreibweise zum Setzen der meisten textbezogenen Dekorationseigenschaften, einschließlich text-decoration-line, text-decoration-color, und text-decoration-style. Sie setzt jedoch nicht text-underline-position.