Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

text-overflow — signaler un texte qui déborde

La propriété text-overflow définit la présentation du contenu qui dépasse le bord d’une ligne : il est coupé ou suivi d’une ellipse. Elle ne limite pas la largeur et ne provoque pas de débordement à elle seule.

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

Syntaxe

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

text-overflow contrôle la présentation du contenu en ligne qui déborde d’une ligne dans un conteneur de bloc dont overflow est différent de visible. Sa valeur initiale est clip ; la propriété n’est pas héritée.

clip coupe le contenu, éventuellement au milieu d’un caractère. ellipsis réserve de la place pour une ellipse, normalement … (U+2026), en masquant le contenu nécessaire. La propriété modifie la présentation, pas le texte source ni la mise en page. Si l’espace manque, le marqueur lui-même peut être coupé.

Pour le cas habituel d’une seule ligne, combinez une largeur contrainte, overflow: hidden, white-space: nowrap et text-overflow: ellipsis. La propriété seule n’empêche pas les retours à la ligne et ne limite pas le nombre de lignes. Une valeur unique s’applique à la fin de la ligne : normalement au bord droit avec direction: ltr, et au bord gauche avec direction: rtl.

Le brouillon CSS Overflow Level 4 ajoute <string>, fade, fade() et une forme à deux valeurs : le bord line-left, puis le bord line-right, et non le début et la fin selon la direction du texte. Ce sont des extensions de brouillon, pas une garantie de prise en charge par les navigateurs ; vérifiez-les séparément dans l’environnement cible.

Exemples

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

Résultat

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.

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources