Word-spacing - Propriété CSS

word-spacing

Résumé des caractéristiques de la propriété word-spacing

Description rapide
Permet d'ajuster l'espacement des mots.
Statut
Standard
S'applique à
Éléments contenant du texte.
Utilisable sur
HTML,SVG
Valeurs prédéfinies
normal
Pourcentages
Calculés par rapport à la taille des caractères.
Valeur initiale
normal
Héritée par défaut
Oui.
Type d'animation
Computed value : lors d'une animation, la propriété word-spacing passe progressivement d'une valeur à une autre.
Module W3C
Module CSS - Texte
Références (W3C)
 🡇  
 🡅  
Statut du document: WD (document de travail)

Statut du document: CR (document candidat à la recommandation)

Statut du document: REC (recommandation)

Statut du document: DEPR (Ancienne spécification, déclarée obsolète)
Syntaxe de word-spacingSchéma syntaxique de la propriété CSS word-spacing. normal normal length / % length / %word-spacing:;word-spacing:;
Schéma syntaxique de la propriété word-spacing.
Cliquez sur les liens du schéma pour plus de précisons sur les valeurs.

Description des termes utilisés sur le schéma :

  • length est une valeur numérique suivie d'une des unités de dimension.
  • % est un pourcentage dont l'évaluation correspond à une dimension.

Description de la propriété word-spacing.

La propriété word-spacing définit l'espace entre les mots, ou plus précisément, la valeur à ajouter ou à retrancher de l'espacement normal.

Les séparateurs de mots concernés sont essentiellement, pour les langues latines, l'espace classique et l'espace insécable ( ).

Notez que l'espace entre les caractères peut également être modifié par la propriété CSS letter-spacing.

Mécanisme d'héritage.

La propriété word-spacing est héritée par défaut, après une particularité pour les pourcentages. En effet, ceux-ci sont hérités en tant que valeurs de pourcentages, et sont donc recalculés en fonction de la taille de caractères des éléments enfants.

Texte de l'élément parent, les mots sont espacés de 100%
Texte de l'élément enfant

Valeurs pour word-spacing.

  • word-spacing: normal;

    Valeur par défaut. L'espace entre les mots est celui qui est défini par la police.

  • word-spacing: 1px;

    La valeur est un nombre positif ou négatif, suivi d'une des unités de dimension ou un pourcentage.

    L'espace entre les mots sera augmenté de la valeur indiquée. S'il s'agit d'une valeur négative, l'espace entre mots sera réduit d'autant. Avec une valeur négative trop importante, les mots peuvent même se superposer.

    Si la valeur est exprimée en pourcentages, ces derniers sont évalués par rapport à la taille des caractères. Mais l'indication en pourcentages souffre encore de nombreux problèmes de compatibilité.

  • word-spacing: initial; (normal) word-spacing: inherit; word-spacing: revert; word-spacing: revertLayer; word-spacing: unset;

    Les valeurs communes sont présentées sur ces pages : initial, inherit, revert, revert-layer, unset.

Exemple d'animation de word-spacing.

Ci-dessous, un exemple d'Exemple d'animation de word-spacing.

Animation de l'espacement des mots

Accéder à la propriété word-spacing par programme.

Avec Javascript, modifier la valeur de word-spacing.

En Javascript, voici comment modifier la valeur de word-spacing. Javascript accepte une syntaxe avec la notation typique de CSS, en kebab-case (un tiret pour séparer les mots), et une autre syntaxe avec la notation en camel-case (une majuscule pour séparer les mots).

Javascript
let el = document.getElementById('id'); el.style['word-spacing'] = '10px'; // ou let el = document.getElementById('id'); el.style.wordSpacing = '10px';

Avec Javascript, lire la valeur de word-spacing.

Ce code renvoie la valeur de la propriété si celle-ci a été affectée directement à l'élément lui-même et pas en passant par un sélecteur. La valeur est renvoyée telle qu'elle a été définie, avec la même unité.

Javascript
let el = document.getElementById('id'); let value = el.style['word-spacing']; // ou let el = document.getElementById('id'); let value = el.style.wordSpacing;

Avec Javascript, lire la valeur calculée de word-spacing.

La valeur calculée est celle qui résulte de l'évaluation des unités relatives (en particulier le pourcentage) et de la prise en compte éventuelle des valeurs héritées.
Dans le cas de word-spacing, la valeur est retournée en pixels ou en pourcentages.

Javascript
let el = document.getElementById('id'); let value = window.getComputedStyle(el).getPropertyValue('word-spacing');

Avec JQuery, modifier la valeur de word-spacing.

JQuery

$('#id').css('word-spacing', '10px');
// ou
$('#id').css('wordSpacing', '10px');

Avec JQuery, lire la valeur calculée de word-spacing.

JQuery
let value = $('#id').css('word-spacing');

Autres exemples de code.

D'autres exemples de code Javascript et JQuery sont donnés sur la page Javascript et CSS.

Testez vous-même.

Les boutons ci-dessous appliquent la valeur saisie à la propriété et affichent ensuite soit la valeur telle qu'elle a été appliquée, soit la valeur calculée. Cette deuxième option permet de voir comment est mémorisée (sérialisée) la valeur de word-spacing. On constate en particulier que les pourcentages sont bien mémorisés en tant que pourcentages (voir le chapitre sur l'héritage). Toutes les autres unités sont converties en pixels.

Exemple interactif avec la propriété word-spacing.

word-spacing :
HTML
La propriété word-spacing gère l'espacement des mots, tandis que l'espacement des lettres peut être ajusté avec letter-spacing.
SVG
C'est la même chose en SVG

Compatibilité des navigateurs avec word-spacing.

La propriété word-spacing en elle-même est très bien reconnue par les navigateurs actuels. Il reste cependant quelques problèmes de compatibilité avec la valeur exprimée en pourcentages (2025).

Colonne 1
Support par les navigateurs de la propriété word-spacing qui définit l'espacement des mors dans un texte.
Colonne 2
Support de la valeur exprimée en pourcentages pour la propriété word-spacing.
1
Propriété
word-spacing
2
Valeur en
pourcentage
Estimation de la prise en charge globale.
96%
19%

Navigateurs sur ordinateurs :

Navigateurs sur mobiles :

Navigateurs obsolètes ou marginaux :

Internet Explorer

Opéra

Firefox

QQ Browser

Safari

Safari sur IOS

Androïd Brower

Chrome pour Androïd

Firefox pour Androïd

Opéra Mobile

Baidu Browser

KaiOS Browser

UC Browser pour Androïd

Samsung Internet

Chrome

Edge

Opéra mini

Histoire de la propriété word-spacing.

A propos de la gestion des textes, voir aussi.

La propriété word-spacing est décrite dans la spécification CSS Text Module, de même que tout ce qui concerne la gestion des textes (alignement, espacements, césure, débordement, etc...). Les propriétés suivantes figurent également dans ce module de spécification :

Propriétés :

hanging-punctuation
Définit la ponctuation suspendue (caractères autorisés à déborder dans la marge).
hyphenate-character
Définit le caractère qui sera à utiliser comme marque de césure.
hyphenate-limit-chars
Définit le nombre minimal de caractères pour autoriser la césure d'un mot.
hyphenate-limit-last
Définit si les césures sont autorisées à la fin d'une colonne, d'une page, etc.
hyphenate-limit-lines
Définit le nombre maximal de lignes successives se terminant une césure
hyphenate-limit-zone
Définit le nombre maximal d'espaces pour autoriser ou interdire la césure.
hyphens
Définit si les mots peuvent être coupés en fin de ligne. La césure des mots donne une mise en page plus agréable mais peut être gênante dans certains cas.
letter-spacing
Espacement des lettres.
line-break
Définit les ruptures de lignes pour les langues CJK (chinois, japonais, coréen).
line-padding
Ajoute un espace au début et à la fin des lignes.
overflow-wrap
Gestion des coupures de mots pour les langues CJK et quelques autres.
tab-size
Définit la taille des caractères de tabulation.
text-align
Spécifie comment doit être aligné le texte de l'élément.
text-align-all
Définit l'alignement des lignes d'un texte (synonyme de text-align).
text-align-last
Définit l'alignement de la dernière ligne des paragraphes.
text-autospace
Définit l'espace entre les caractères adjacents (utilisable pour les langues CJK).
text-group-align
text-indent
Définit le retrait de la première ligne des paragraphe (indentation).
text-justify
Sélectionne la méthode utilisée pour justifier le texte.
text-space-collapse
Définit comment gérer les espaces et les espaces multiples dans le texte.
text-space-trim
Définit si les espaces au début et à la fin du texte de l'élément doivent être conservés ou supprimés.
text-spacing
text-spacing-trim
Definit l'espacement autour des caractères de ponctuation CJK.
text-transform
Casse du texte (minuscules, majuscules...).
text-wrap
Définit la gestion des retours à la ligne du texte.
text-wrap-mode
Définit si les retours à la ligne sont autorisés.
text-wrap-style
Définit comment les saut de ligne vont se faire.
white-space
Définit comment sont restitués les espaces multiples et les retours chariot.
white-space-collapse
Définit comment les espaces successifs et les retours à la ligne doivent être traités.
white-space-trim
Définit si comment le navigateur doit supprimer les espaces réductibles.
word-boundary-detection
Définit quelle logique le navigateur doit utilier pour identifier les limites des mots.
word-boundary-expansion
Substitue certains caractères de séparation de mots par d'autres.
word-break
Coupure des mots longs.
word-space-transform
Normalise les caractères d'espacement (écritures CJK).
word-wrap
Coupure des mots pour les langues CJK et quelques autres.
wrap-after
Autorise ou non les sauts de lignes après la boite.
wrap-before
Autorise ou non les sauts de lignes avant la boite.
wrap-inside
Autorise ou non les sauts de lignes dans la boite.