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

VeröffentlichtToolCSS-Ellipsis-Generator

Inhalt
  1. Ein typisches Problem bei Karten-Listen
  2. Einzeiliges Abschneiden: Wann text-overflow funktioniert
  3. Mehrzeiliges Abschneiden: Warum vier Eigenschaften zusammengehören
  4. Warum line-clamp-Wert und Containerbreite das Ergebnis verändern
  5. Häufige Stolperstellen
  6. Fazit
  7. Häufig gestellte Fragen

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-clamp funktioniert nur zusammen mit display: -webkit-box, -webkit-box-orient: vertical und overflow: hidden. ② Einzeiliges Abschneiden erreichen Sie mit white-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 der line-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.

CSS-Ellipsis-Generator

Ä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:

SymptomUrsache
Der line-clamp-Wert ist gesetzt, aber es wird nichts abgeschnittendisplay: -webkit-box und -webkit-box-orient: vertical fehlen
Die Zeilenzahl stimmt, aber der Text ragt nach unten herausoverflow: hidden fehlt
Der Code für einzeiliges Abschneiden wurde unverändert auf mehrere Zeilen angewendettext-overflow: ellipsis funktioniert nur bei einer einzelnen Zeile mit nowrap
Auch bei geänderter Breite passiert nichtsDer 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-clamp funktioniert nur zusammen mit display: -webkit-box, -webkit-box-orient: vertical und overflow: 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.
CSS-Ellipsis-Generator

Ä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

Ähnliche Artikel

  1. Aufzählungszeichen umwandeln: Markdown, HTML und eigene SymboleSo wandeln Sie Fließtext oder Listen in Markdown-Listen, HTML-Listen mit ul und li oder eigene Aufzählungszeichen um – samt typischer Stolperstellen.
  2. Local Storage vs. Session Storage: Unterschiede im ÜberblickSpeicherdauer von Local Storage und Session Storage, Werte in den Entwicklertools prüfen und die Ursache von QuotaExceededError verstehen.
  3. Koreanisches Manuskriptpapier: Blattzahl richtig berechnenWarum Zeichenzahl ÷ 200 nicht die Blattzahl ergibt und wie Absatzeinzug und Zeilenumbruch die Berechnung auf Manuskriptpapier mit 200 Feldern beeinflussen.
  4. Markdown in HTML umwandeln: Regeln und CSS-StylingSo wird Markdown-Syntax zu HTML-Tags: die wichtigsten Umwandlungsregeln plus CSS-Typografie, mit der das Ergebnis gut lesbar aussieht.
  5. Markdown-Tabelle in HTML und JSON umwandeln: Regeln & StolpersteineWie Markdown-Tabellen, HTML-table-Tags und JSON-Arrays ineinander übersetzt werden: Kopfzeilen-Erkennung und der Umgang mit abweichender Spaltenzahl.
  6. Textdateien zusammenführen: TXT-Dateien ohne Zeichensalat verbindenSo führen Sie mehrere TXT-Dateien zusammen, nutzen Trennzeichen und Datei-Header und vermeiden kaputte Zeichen durch falsche Kodierung wie EUC-KR.

Passende Tools