Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

text-overflow — oznaczanie przepełnienia tekstu

Właściwość text-overflow określa sposób prezentacji treści wychodzącej poza krawędź wiersza: przycięcie albo wielokropek. Sama nie ogranicza szerokości i nie wymusza przepełnienia.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

text-overflow: clip | ellipsis;
/* CSS Overflow Level 4 draft: */
text-overflow: [ clip | ellipsis | <string> | fade | <fade()> ]{1,2};

text-overflow steruje prezentacją treści śródliniowej przepełniającej wiersz w kontenerze blokowym, którego overflow jest inne niż visible. Wartością początkową jest clip; właściwość nie jest dziedziczona.

clip przycina treść, także w środku znaku. ellipsis rezerwuje miejsce na wielokropek, zwykle … (U+2026), ukrywając odpowiednią część treści. Zmienia prezentację, nie tekst źródłowy ani układ. Przy zbyt małej ilości miejsca sam znacznik może zostać przycięty.

W typowym przypadku jednego wiersza połącz ograniczoną szerokość, overflow: hidden, white-space: nowrap i text-overflow: ellipsis. Sama właściwość nie zapobiega zawijaniu ani nie ogranicza liczby wierszy. Jedna wartość dotyczy końca wiersza: zwykle prawej krawędzi dla direction: ltr, lewej dla direction: rtl.

Projekt CSS Overflow Level 4 dodaje <string>, fade, fade() oraz zapis dwuwartościowy: krawędź line-left, potem line-right, a nie początek i koniec kierunku tekstu. Są to rozszerzenia projektu, nie gwarancja obsługi w przeglądarce; sprawdź je osobno w docelowym środowisku.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>text-overflow</title>
<style>
  .sample {
    width: 12ch;
    overflow: hidden;
    white-space: nowrap;
    font: 20px/1.5 monospace;
    direction: ltr;
    border: 1px solid;
  }
  .clip { text-overflow: clip; }
  .ellipsis { text-overflow: ellipsis; }
</style>
<body>
  <p class="sample clip">ABCDEFGHIJKLMNOPQRSTUVWXYZ</p>
  <p class="sample ellipsis">ABCDEFGHIJKLMNOPQRSTUVWXYZ</p>
</body>
</html>

Wynik

Two bordered single-line boxes: the first clips the alphabet at the right edge; the second shows a shortened prefix followed by an ellipsis. The exact visible prefix depends on font metrics.

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła