text-wrap-mode

Baseline 2024
Newly available

Since October 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die text-wrap-mode CSS-Eigenschaft steuert, ob der Text innerhalb eines Elements umbrochen wird. Die verschiedenen Werte bieten alternative Möglichkeiten, den Inhalt eines Blockelements umzubrechen. Sie kann auch durch die text-wrap-Kurzform oder die white-space-Kurzform gesetzt und zurückgesetzt werden.

Hinweis: Die Eigenschaften white-space-collapse und text-wrap-mode können zusammen mit der white-space-Kurzform-Eigenschaft deklariert werden.

Hinweis: Der Name dieser Eigenschaft ist ein Platzhalter, bis die CSSWG einen besseren Namen gefunden hat.

Probieren Sie es aus

text-wrap-mode: wrap;

text-wrap-mode: nowrap;

<section class="default-example" id="default-example">
  <div class="whole-content-wrapper">
    <p>Edit the text in the box:</p>
    <div class="transition-all" id="example-element">
      <p contenteditable="">
        Lorem ipsum dolor sit amet consectetur adipisicing elit. Voluptatem aut
        cum eum id quos est.
      </p>
    </div>
  </div>
</section>

.whole-content-wrapper {
  display: flex;
  flex-direction: column;
  align-items: center;
  width: 100%;
}

#example-element {
  border: 1px solid #c5c5c5;
  width: 250px;
}

Syntax

css
/* Keyword values */
text-wrap-mode: wrap;
text-wrap-mode: nowrap;

/* Global values */
text-wrap-mode: inherit;
text-wrap-mode: initial;
text-wrap-mode: revert;
text-wrap-mode: revert-layer;
text-wrap-mode: unset;

Werte

Diese Eigenschaft gibt an, ob Zeilen bei nicht erzwungenen weichen Umbruchmöglichkeiten umbrochen werden dürfen. Mögliche Werte:

wrap

Text wird bei passenden Zeichen (beispielsweise Leerzeichen in Sprachen wie Englisch, die Leerzeichentrenner verwenden) umgebrochen, um Überlauf zu minimieren. Dies ist der Standardwert.

nowrap

Text wird nicht über Zeilen umgebrochen. Er wird das enthaltene Element überlaufen, anstatt in eine neue Zeile zu brechen.

Formale Definition

Anfangswertwrap
Anwendbar auftext and block containers
VererbtJa
Berechneter Wertwie angegeben
Animationstypdiskret

Formale Syntax

text-wrap-mode = 
  wrap    |
  nowrap

Beispiele

Inhalt umbrechen

Die Standardeinstellung ist, den Inhalt umzubrechen, daher ist die text-wrap-mode-Eigenschaft nicht erforderlich. In diesem Beispiel wird der Inhalt auf die nächste Zeile umfließen, sodass er in das Kästchen passt, die letzte Zeile ist länger als das enthaltene Kästchen und läuft über.

HTML

html
<div class="box">CSS IS AWESOME</div>

CSS

css
.box {
  font-family: Arial, sans-serif;
  font-weight: bold;
  font-size: 64px;
  box-sizing: border-box;
  border: 4px solid black;
  padding: 0px 3px;
  width: 223px;
  text-wrap-mode: wrap;
}

Ergebnis

Inhalt nicht umbrechen

In diesem Beispiel wird der Inhalt nicht auf die nächste Zeile umfließen, sodass er in das Kästchen passt, da der Inhalt ausdrücklich angewiesen wurde, nicht mit text-wrap-mode: nowrap; umbrochen zu werden. Der Inhalt ist länger als das enthaltene Kästchen und läuft über.

HTML

html
<div class="box">CSS IS AWESOME</div>

CSS

css
.box {
  font-family: Arial, sans-serif;
  font-weight: bold;
  font-size: 64px;
  box-sizing: border-box;
  border: 4px solid black;
  padding: 0px 3px;
  width: 223px;
  text-wrap-mode: nowrap;
}

Ergebnis

Spezifikationen

Specification
CSS Text Module Level 4
# text-wrap-mode

Browser-Kompatibilität

Siehe auch