Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

text-overflow — indicare il testo in overflow

La proprietà text-overflow stabilisce come presentare il contenuto che supera il bordo di una riga: tagliandolo oppure mostrando i puntini di sospensione. Non limita la larghezza né crea overflow da sola.

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

Sintassi

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

text-overflow controlla la presentazione del contenuto in linea che supera una riga in un contenitore di blocco il cui overflow è diverso da visible. Il valore iniziale è clip; la proprietà non è ereditata.

clip taglia il contenuto, anche in mezzo a un carattere. ellipsis riserva spazio per i puntini di sospensione, normalmente … (U+2026), nascondendo il contenuto necessario. Modifica la presentazione, non il testo sorgente né il layout. Se lo spazio non basta, anche il marcatore può essere tagliato.

Nel caso comune di una sola riga, combina una larghezza limitata, overflow: hidden, white-space: nowrap e text-overflow: ellipsis. La proprietà da sola non impedisce gli a capo né limita il numero di righe. Un singolo valore agisce sulla fine della riga: normalmente sul bordo destro con direction: ltr e su quello sinistro con direction: rtl.

La bozza CSS Overflow Level 4 aggiunge <string>, fade, fade() e una forma con due valori: prima il bordo line-left, poi quello line-right, non l’inizio e la fine in base alla direzione del testo. Sono estensioni della bozza, non una garanzia di supporto nei browser; verificale separatamente nell’ambiente di destinazione.

Esempi

<!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>

Risultato

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.

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti