Propriété CSSTypographie

text-indent

Définit le retrait de la première ligne de texte dans un bloc.

Valeur initiale
0
Héritée
Oui
Animable
oui, en tant que longueur ou pourcentage
S’applique à
conteneurs de bloc
JavaScript
element.style.textIndent = "2em"
Sur cette page

Exemple

#
CSS
.book p + p {
  text-indent: 1.5em;
  margin-top: 0;
}
Aperçu

Définition et utilisation

#

La propriété text-indent décale la première ligne de texte d’un bloc de la valeur indiquée. C’est l’allure classique d’un paragraphe de livre : la première ligne commence avec un retrait, les suivantes partent du bord.

Une valeur négative crée ce qu’on appelle un retrait négatif : la première ligne dépasse vers la gauche par rapport aux autres. On l’utilise par exemple dans les bibliographies.

Les pourcentages se calculent par rapport à la largeur du bloc. Le retrait ne concerne que la première ligne du bloc ; même après un retour à la ligne forcé par <br>, il ne se répète pas.

Syntaxe

#
Syntaxe
text-indent: <longueur> | <pourcentage>;

Valeurs

#
  • 0

    La première ligne commence au bord.
  • 2em

    <longueur>

    Le retrait classique d’un paragraphe.
  • -1.5em

    valeur négative

    Un décalage de la première ligne vers la gauche.

Valeurs en pratique

#

0

La première ligne commence au bord.
.demo { text-indent: 0; }

2em

Le retrait classique d’un paragraphe.
.demo { text-indent: 2em; }

-1.5em

Un décalage de la première ligne vers la gauche.
.demo { text-indent: -1.5em; padding-left: 1.5em; }

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • En typographie de livre, on utilise soit un retrait, soit un espace entre les paragraphes, rarement les deux à la fois.
  • Ne masquez pas de texte avec un grand retrait négatif. L’ancienne astuce text-indent: -9999px nuit à l’accessibilité.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.