text-overflow
Übersicht
Die text-overflow
CSS Eigenschaft bestimmt, wie überlaufende Inhalte die nicht angezeigt werden (Siehe overflow
) dem Nutzer signalisiert werden. Sie können abgeschnitten (clipped) oder durch ein Auslassungszeichen ('…
', U+2026 Horizontal Ellipsis
) beziehungsweise eine vom Webautor definierte Zeichenfolge markiert sein.
Das Abschneiden des überlaufenden Textes findet exakt am Rand des Inhaltselements statt. Um erst nach einem vollen Zeichen abzuschneiden, kann eine leere benutzerdefinierte Zeichenfolge angegeben werden (' ').
Diese Eigenschaft beeinflusst nur Inhalte, welche aus einem Blockelement in dessen inline-Richtung überlaufen (beispielsweise wird Text der am unteren Ende eines Kastens überläuft nicht beeinflusst). Ein Textüberlauf kann auftreten, wenn ein Text-wrapping verhindert wird (z.B., durch ‘
’) oder wenn ein einzelnes Wort zu lang ist.white-space:nowrap
Diese CSS Eigenschaft erzwingt keinen Textüberlauf; um dies zu erreichen und somit die text-overflow
-Eigenschaft anzuwenden, muss der Autor dem Element weitere Eigenschaften zuweisen, u. a. den overflow
auf hidden
setzen.
Initialwert | clip |
---|---|
Anwendbar auf | Blockcontainerelemente |
Vererbt | Nein |
Berechneter Wert | wie angegeben |
Animationstyp | diskret |
Syntax
/* Überlaufverhalten am Zeilenende
Rechtes Ende, falls links nach rechts, linkes Ende, falls rechts nach links */
text-overflow: clip;
text-overflow: ellipsis;
text-overflow: "…";
/* Überlaufverhalten am linken/rechten Ende
Richtung hat keinen Einfluss */
text-overflow: clip ellipsis;
text-overflow: "…" "…";
/* Globale Werte */
text-overflow: inherit;
text-overflow: initial;
text-overflow: unset;
Werte
clip
- Dieses Schlüsselwort führt dazu, dass Text genau am Ende des Inhaltsbereichs abgeschnitten wird. Daher kann der Schnitt auch innerhalb eines Zeichens geschehen. Um am Übergang zwischen zwei Zeichen abzuschneiden, muss eine leere Zeichenfolge (
''
) verwendet werden. Der Wertclip
ist der Standardwert für diese Eigenschaft. ellipsis
- Dieses Schlüsselwort führt dazu, dass ein Auslassungszeichen (
'…'
,U+2026 Horizontal Ellipsis
) an der Schnittstelle angezeigt wird, um abgeschnittenen Text zu repräsentieren. Das Auslassungszeichen wird innerhalb des Inhaltsbereichs angezeigt, wodurch die Menge des angezeigten Texts verringert wird. Wenn nicht genug Platz für das Auslassungszeichen selbst zur Verfügung steht, wird es abgeschnitten. <string>
- Der
<string>
, welcher zur Anzeige des abgeschnittenen Texts genutzt werden soll. Diese Zeichenfolge wird innerhalb des Inhaltsbereichs angezeigt und führt dazu, dass die Menge des angezeigten Texts verringert wird. Wenn nicht genug Platz für die Zeichenfolge selbst zur Verfügung steht, wird sie abgeschnitten.
Formale Syntax
Beispiele
p {
white-space: nowrap;
width: 100%;
overflow: hidden; /* "overflow"-Wert darf nicht "visible" sein */
text-overflow: ellipsis;
}
CSS Wert | direction: ltr |
direction: rtl |
||
---|---|---|---|---|
Erwartetes Ergebnis | Live-Ergebnis | Erwartetes Ergebnis | Live-Ergebnis | |
visible overflow | 1234567890 |
1234567890
|
0987654321 |
1234567890
|
text-overflow: clip |
![]() |
![]() |
||
text-overflow: '' |
12345 | 54321 | ||
text-overflow: ellipsis |
1234… | …4321 | ||
text-overflow: '.' |
1234. | .4321 | ||
text-overflow: clip clip |
123456 | 654321 | ||
text-overflow: clip ellipsis |
1234… | 6543… | ||
text-overflow: clip '.' |
1234. | 6543. | ||
text-overflow: ellipsis clip |
…3456 | …4321 | ||
text-overflow: ellipsis ellipsis |
…34… | …43… | ||
text-overflow: ellipsis '.' |
…34. | …43. | ||
text-overflow: ',' clip |
,3456 | ,4321 | ||
text-overflow: ',' ellipsis |
,34… | ,43… | ||
text-overflow: ',' '.' |
,34. | ,53. |
Spezifikationen
Spezifikation | Status | Kommentar |
---|---|---|
CSS Basic User Interface Module Level 3 Die Definition von 'text-overflow' in dieser Spezifikation. |
Empfehlung | Ursprüngliche Definition |
Eine vorherige Version dieser Schnittstelle erreichte den Candidate Recommendation-Status (CR). Da einige der nicht aufgeführten gefährdeten Eigenschaften entfernt werden mussten, wurde die Spezifikation auf Working Draft-Niveau herabgesetzt. Das erklärt, weshalb Browser diese Eigenschaft ohne Präfix, jedoch nicht im CR-Zustand, umgesetzt haben. Momentan hat die Spezifikation das Editor's Draft-Niveau erreicht.
Browser Kompatibilität
BCD tables only load in the browser
Siehe auch
- Verwandte CSS Eigenschaften:
overflow
,white-space