line-clamp in CSS: Warum es nicht funktioniert und wie es geht

Inhalt
Sie haben -webkit-line-clamp: 3; ins CSS geschrieben, aber der mehrzeilige Text wird trotzdem nicht mit Auslassungspunkten abgeschnitten? Dann liegt es fast immer an derselben Ursache.
line-clamp funktioniert nur, wenn vier Eigenschaften zusammen gesetzt sind: -webkit-line-clamp, display: -webkit-box, -webkit-box-orient: vertical und overflow: hidden. Fehlt auch nur eine davon, wird die Angabe einfach ignoriert.
Dieser Beitrag richtet sich an alle, die auf Seiten mit unterschiedlich langen Texten, etwa bei Kartentiteln oder Listenvorschauen, eine feste Zeilenzahl erreichen möchten.
Zusammenfassung ①
-webkit-line-clampfunktioniert nur zusammen mitdisplay: -webkit-box,-webkit-box-orient: verticalundoverflow: hidden. ② Einzeiliges Abschneiden erreichen Sie mitwhite-space: nowrap+text-overflow: ellipsis, mehrzeiliges mit-webkit-line-clamp. Das sind unterschiedliche Kombinationen von Eigenschaften. ③ Auch bei gleichem Text ändert sich die Stelle, an der abgeschnitten wird, sobald sich derline-clamp-Wert oder die Breite des Containers ändert.
Ein typisches Problem bei Karten-Listen
Bei Übersichten mit mehreren Einträgen, etwa Forenlisten oder Produktlisten, wirkt das Layout nur dann aufgeräumt, wenn alle Karten gleich hoch sind. Die Länge von Titeln oder Kurztexten ist aber von Eintrag zu Eintrag verschieden.
Karten mit kurzem Text haben leeren Raum übrig, Karten mit langem Text werden höher als die anderen.
Um das zu lösen, suchen viele nach -webkit-line-clamp und fügen im CSS nur diese eine Zeile hinzu. Dann bricht der Text jedoch weiter um, und die Auslassungspunkte erscheinen nicht.
Der Grund: -webkit-line-clamp ist keine Eigenschaft, die allein funktioniert.
Einzeiliges Abschneiden: Wann text-overflow funktioniert
Beim einzeiligen und beim mehrzeiligen Abschneiden legt der Browser nach unterschiedlichen Kriterien fest, wo der Text endet. Deshalb unterscheiden sich auch die verwendeten Eigenschaften. Für eine einzelne Zeile genügen diese drei:
.truncate-single {
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}
white-space: nowrap unterbindet den Zeilenumbruch und erzwingt eine einzige Zeile. overflow: hidden schneidet alles ab, was über die Breite des Containers hinausgeht. text-overflow: ellipsis setzt an der Schnittstelle die Auslassungspunkte.
Jede der drei Eigenschaften übernimmt also einen eigenen Teil der Aufgabe.
Mehrzeiliges Abschneiden: Warum vier Eigenschaften zusammengehören
text-overflow: ellipsis wirkt nur, wenn ein mit nowrap auf eine Zeile festgelegter Text horizontal überläuft. Auf mehrzeiligen Text, der umgebrochen wird, lässt es sich daher nicht anwenden.
Für mehrzeiliges Abschneiden verwendet man deshalb eine andere Kombination:
.truncate-multi {
display: -webkit-box;
-webkit-box-orient: vertical;
-webkit-line-clamp: 3;
overflow: hidden;
}
Diese vier Eigenschaften wirken nicht einzeln, sondern ergeben erst gemeinsam eine vollständige Anweisung.
display: -webkit-box und -webkit-box-orient: vertical aktivieren das Layoutmodell, in dem -webkit-line-clamp überhaupt ausgewertet wird. Fehlen sie, erkennt der Browser den Wert -webkit-line-clamp: 3 gar nicht und ignoriert ihn.
overflow: hidden blendet den Inhalt, der über die angegebene Zeilenzahl hinausgeht, tatsächlich aus. Fehlt diese Eigenschaft, wird der überzählige Text nicht abgeschnitten und läuft sichtbar nach unten weiter.
Fehlt eine der vier Eigenschaften, greift das Abschneiden entweder gar nicht oder nur zur Hälfte.
Warum line-clamp-Wert und Containerbreite das Ergebnis verändern
Ändern Sie die Zeilenzahl (den line-clamp-Wert) oder die Breite des Containers, ändert sich auch das Ergebnis. Der Browser bricht den Text nämlich zuerst anhand der Containerbreite um und behält von den entstandenen Zeilen nur bis zur angegebenen Zeile.
Wird der Container bei gleichem Text breiter, passen mehr Zeichen in eine Zeile, und innerhalb derselben Zeilenbegrenzung wird mehr Inhalt angezeigt.
Wird er schmaler, kommt es umgekehrt häufiger zu Zeilenumbrüchen, und bei gleicher Zeilenbegrenzung sind weniger Zeichen sichtbar. Der line-clamp-Wert bestimmt die Anzahl der angezeigten Zeilen, die Containerbreite die Zahl der Zeichen pro Zeile. Es sind zwei voneinander unabhängige Größen.
Probieren Sie es mit dem CSS-Ellipsis-Generator von Dynamic Labs aus.
Ändern Sie Modus, Zeilenanzahl und Container-Breite, und der CSS-Code passt sich sofort an. Der Text wird nicht aus dem Browser heraus übertragen.

Häufige Stolperstellen
Beim ersten Einsatz von line-clamp treten meist die folgenden Probleme auf:
| Symptom | Ursache |
|---|---|
Der line-clamp-Wert ist gesetzt, aber es wird nichts abgeschnitten | display: -webkit-box und -webkit-box-orient: vertical fehlen |
| Die Zeilenzahl stimmt, aber der Text ragt nach unten heraus | overflow: hidden fehlt |
| Der Code für einzeiliges Abschneiden wurde unverändert auf mehrere Zeilen angewendet | text-overflow: ellipsis funktioniert nur bei einer einzelnen Zeile mit nowrap |
| Auch bei geänderter Breite passiert nichts | Der Container hat gar keine Breitenbegrenzung (oder max-width) |
Wegen des Präfixes -webkit- wirkt die Eigenschaft wie eine reine Safari-Funktion. Inzwischen erkennen aber die meisten aktuellen Browser wie Chrome, Edge und Firefox sie ebenfalls.
Wenn Sie auch ältere Browser unterstützen müssen, ist es sicherer, einen Ersatzstil wie das einzeilige Abschneiden (text-overflow: ellipsis) zusätzlich vorzubereiten.
Fazit
-webkit-line-clampfunktioniert nur zusammen mitdisplay: -webkit-box,-webkit-box-orient: verticalundoverflow: hidden.- Einzeiliges Abschneiden (
white-space: nowrap+text-overflow: ellipsis) und mehrzeiliges Abschneiden (-webkit-line-clamp) beruhen auf unterschiedlichen Kriterien und brauchen daher verschiedene Kombinationen von Eigenschaften. - Der
line-clamp-Wert legt die Zahl der angezeigten Zeilen fest, die Containerbreite die Zahl der Zeichen pro Zeile. - Fehlt eine der vier Eigenschaften, greift die Zeilenbegrenzung nicht, oder der überschüssige Text bleibt sichtbar.
Ändern Sie Modus, Zeilenanzahl und Container-Breite, und der CSS-Code passt sich sofort an. Der Text wird nicht aus dem Browser heraus übertragen.
Häufig gestellte Fragen
Funktioniert -webkit-line-clamp in allen Browsern?
Die meisten aktuellen Browser wie Chrome, Edge, Safari und Firefox erkennen -webkit-line-clamp.
Da es sich, wie der Name schon sagt, um eine Eigenschaft mit WebKit-Präfix handelt, sollten Sie bei Bedarf an ältere Browser zusätzlich einen Ersatzstil wie das einzeilige Abschneiden vorsehen.
Warum braucht man für einzeiliges und mehrzeiliges Abschneiden unterschiedliche Eigenschaften?
Beim einzeiligen Abschneiden verhindert white-space: nowrap den Zeilenumbruch, und der horizontal überlaufende Teil wird mit text-overflow: ellipsis gekennzeichnet.
Das mehrzeilige Abschneiden setzt voraus, dass Zeilenumbrüche stattfinden. Deshalb kommt -webkit-line-clamp zum Einsatz, das alles ausblendet, was über die angegebene Zeilenzahl hinausgeht.
Weil sich das Kriterium unterscheidet, ob also horizontal in einer Zeile oder vertikal über mehrere Zeilen abgeschnitten wird, unterscheiden sich auch die Kombinationen der Eigenschaften.
Ich habe einen line-clamp-Wert gesetzt, aber der Text wird komplett angezeigt. Woran liegt das?
Wahrscheinlich fehlen display: -webkit-box und -webkit-box-orient: vertical.
-webkit-line-clamp wird nur in dem Layoutmodell ausgewertet, das diese beiden Eigenschaften aktivieren. Fehlt eine davon, wird der Wert ignoriert.
Fehlt nur overflow: hidden, ragt der Text nach der Zeilenbegrenzung nach unten heraus.
Warum ändert sich die Zahl der sichtbaren Zeichen, wenn ich die Containerbreite ändere?
Der Browser bricht den Text zuerst anhand der Containerbreite um und behält von den entstandenen Zeilen nur bis zur angegebenen Zeile.
Wird der Container breiter, passen mehr Zeichen in eine Zeile, sodass innerhalb derselben Zeilenbegrenzung mehr Text angezeigt wird. Bei einem schmaleren Container ist es umgekehrt.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen