Propriété CSSTypographie

white-space

Détermine comment traiter les espaces, les retours à la ligne et le retour automatique dans le texte.

Valeur initiale
normal
Héritée
Oui
Animable
non
S’applique à
tous les éléments
JavaScript
element.style.whiteSpace = "nowrap"
Sur cette page

Exemple

#
CSS
.message {
  white-space: pre-line;
}
Aperçu

Définition et utilisation

#

Par défaut, le navigateur réduit plusieurs espaces et retours à la ligne du code à un seul espace, et le texte revient à la ligne automatiquement. La propriété white-space permet de changer ce comportement.

nowrap désactive le retour à la ligne, donc le texte reste sur une seule ligne. pre conserve tous les espaces et retours à la ligne exactement comme dans le code, sans retour automatique. pre-wrap les conserve aussi, mais autorise le retour à la ligne pour les lignes longues, et pre-line ne conserve que les retours à la ligne.

white-space: nowrap associé à overflow: hidden et text-overflow: ellipsis est la recette classique pour tronquer un texte avec des points de suspension.

Syntaxe

#
Syntaxe
white-space: normal | nowrap | pre | pre-wrap | pre-line | break-spaces;

Valeurs

#
  • normal

    Les espaces se réduisent, le texte revient à la ligne automatiquement.
  • nowrap

    Une seule ligne sans retour automatique, le texte dépasse du conteneur.
  • pre

    Les espaces et les retours à la ligne comme dans le code, sans retour automatique.
  • pre-wrap

    Les espaces et les retours à la ligne comme dans le code, avec retour automatique.
  • pre-line

    Les retours à la ligne conservés, les espaces réduits.

Valeurs en pratique

#

normal

Les espaces se réduisent, le texte revient à la ligne automatiquement.
.demo { white-space: normal; }

nowrap

Une seule ligne sans retour automatique, le texte dépasse du conteneur.
.demo { white-space: nowrap; }

pre

Les espaces et les retours à la ligne comme dans le code, sans retour automatique.
.demo { white-space: pre; }

pre-wrap

Les espaces et les retours à la ligne comme dans le code, avec retour automatique.
.demo { white-space: pre-wrap; }

pre-line

Les retours à la ligne conservés, les espaces réduits.
.demo { white-space: pre-line; }

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

#
  • Affichez le texte saisi par l’utilisateur, par exemple un commentaire avec des retours à la ligne, avec white-space: pre-line.
  • Protégez avec nowrap les boutons et les étiquettes qui ne doivent pas se couper sur deux lignes.

Entrées associées

#

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