Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

text-overflow — indicar texto excedente

A propriedade text-overflow define como é apresentado o conteúdo que ultrapassa o limite de uma linha: é cortado ou seguido de reticências. Não limita a largura nem cria overflow por si só.

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

Sintaxe

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

text-overflow controla a apresentação do conteúdo em linha que ultrapassa uma linha num contentor de bloco cujo overflow não é visible. O valor inicial é clip; a propriedade não é herdada.

clip corta o conteúdo, possivelmente a meio de um carácter. ellipsis reserva espaço para reticências, normalmente … (U+2026), ocultando o conteúdo necessário. Altera a apresentação, não o texto de origem nem o esquema. Se não houver espaço suficiente, o próprio marcador também pode ser cortado.

No caso habitual de uma só linha, combine uma largura limitada, overflow: hidden, white-space: nowrap e text-overflow: ellipsis. A propriedade, por si só, não impede a mudança de linha nem limita o número de linhas. Um único valor afeta o fim da linha: normalmente o limite direito com direction: ltr e o esquerdo com direction: rtl.

O rascunho CSS Overflow Level 4 acrescenta <string>, fade, fade() e uma forma com dois valores: primeiro o limite line-left e depois o limite line-right, não o início e o fim de acordo com a direção do texto. São extensões do rascunho, não uma garantia de suporte nos browsers; verifique-as separadamente no ambiente de destino.

Exemplos

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

Resultado

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.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes