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

CKTIS / CSS

text-indent — indentation du texte

text-indent définit le retrait de la première ligne de texte mise en forme. Contrairement à une marge, il ne déplace pas tout le bloc et, contrairement au padding, n’ajoute pas d’espace à chaque ligne.

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

Syntaxe

text-indent: <length-percentage> && hanging? && each-line?;

text-indent s’applique aux conteneurs de bloc et ne décale normalement que la première ligne mise en forme. Le retrait s’applique au bord de début logique de la ligne (inline-start). Le bord physique correspondant dépend du sens de la ligne sur l’axe en ligne et du mode d’écriture, et non du sens d’un segment de texte donné. Par exemple, dans un paragraphe horizontal orienté de droite à gauche, le retrait se fait à droite même si le texte est en anglais. Sa valeur initiale est 0 ; la propriété est héritée.

Indiquez une longueur, par exemple 2em, ou un pourcentage de la taille intérieure du conteneur sur l’axe en ligne. Les valeurs négatives sont autorisées et peuvent faire dépasser le texte du bloc. La syntaxe exige une longueur ou un pourcentage ; les mots-clés facultatifs peuvent apparaître dans n’importe quel ordre.

each-line concerne la première ligne et les lignes qui suivent des sauts forcés, mais pas les retours à la ligne automatiques. hanging inverse la sélection des lignes. Ensemble, ils indentent les continuations dues aux retours automatiques, tout en laissant sans retrait la première ligne et celles qui suivent des sauts forcés. Une définition dans la spécification ne garantit pas la prise en charge par le navigateur cible.

L’exemple utilise uniquement 32px : le décalage attendu de Alpha est de 32px et celui de Beta de 0px. Un saut forcé ne déclenche normalement pas un nouvel retrait. L’exemple doit être vérifié localement.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>text-indent</title>
<style>
  p {
    margin: 0;
    padding: 0;
    border: 1px solid;
    width: 320px;
    font: 16px/24px monospace;
    direction: ltr;
    text-align: start;
    text-indent: 32px;
  }
</style>
<p><span id="first">Alpha</span><br><span id="second">Beta</span></p>

Résultat

Alpha: 32px inline-start offset; Beta: 0px inline-start offset, measured from the paragraph content edge.

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