Text-wrap-style - Propriété CSS

text-wrap-style

Résumé des caractéristiques de la propriété text-wrap-style

Description rapide
Définit comment les saut de ligne vont se faire.
Statut
Standard
Utilisable sur
[html]
Valeurs prédéfinies
auto | balance | stable | pretty
Pourcentages
Ne s'appliquent pas.
Valeur initiale
auto
Héritée par défaut
Oui.
Type d'animation
Discrète : lors d'une animation, la propriété text-wrap-style passe d'une valeur à l'autre sans transition.
Module W3C
Module CSS - Texte
Références (W3C)
Statut du document: WD (document de travail)

Schéma de la syntaxe de text-wrap-style.

text-wrap-style - Syntax DiagramSyntax diagram of the text-wrap-style CSS property. See stylescss.free.fr for details. auto auto balance balance stable stable pretty prettytext-wrap-style:;text-wrap-style:;
Schéma syntaxique de la propriété text-wrap-style.
Cliquez sur les liens du schéma pour plus de précisons sur les valeurs.

Description de la propriété text-wrap-style.

text-wrap-style définit comment se font les sauts à la ligne dans le contexte d'une série de boites du type inline... (inline-block, inline-table, inline-flex, etc).

Cette propriété ne concerne pas les retours à la ligne dans un flex-box, qui sont gérés par la propriété flex-wrap.
Mais vous pouvez vous reportez aux propriétés ci-dessous pour en savoir plus :

  • text-wrap-mode : Définit si les retours à la ligne sont autorisés.
  • wrap-before : Autorise ou non les sauts de lignes avant la boite.
  • wrap-after : Autorise ou non les sauts de lignes après la boite.
  • wrap-inside : Autorise ou non les sauts de lignes dans la boite.

Valeurs pour text-wrap-style.

  • text-wrap-style: auto;

    Le navigateur choisit lui-même l'algorithme à utiliser pour couper les lignes. Il s'agit généralement de l'algorithme le plus rapide. Il s'agit de la valeur initiale de la propriété.

    Cette boîte contient du texte avec des sauts de ligne dus à une largeur trop étroite. Le navigateur choisit l'algorithme à utiliser.
  • text-wrap-style: balance;

    Le navigateur tente d'équilibrer la longueur des lignes. Cette valeur est à préférer pour les légendes

    Le navigateur traite cette valeur comme auto lorsqu'il y a plus de 10 lignes.

    Cette boîte contient du texte avec des sauts de ligne dus à une largeur trop étroite. Le navigateur gère les sauts de ligne pour qu'elles soient le plus égale possible.
  • text-wrap-style: stable;

    Le navigateur choisir l'algorithme qui suppose le moins de modifications possible lorsque le contenu est modifié.

    Cette boîte contient du texte avec des sauts de ligne dus à une largeur trop étroite. Le navigateur gère les sauts de ligne pour que les modifications de contenu aient le moins d'impact possible.
  • text-wrap-style: pretty;

    Le navigateur doit biaiser pour une meilleure disposition et une vitesse élevée, et doit prendre en compte plusieurs lignes, lors de la prise de décisions de retours.

    Cette boîte contient du texte avec des sauts de ligne dus à une largeur trop étroite. Le navigateur trouve un compromis entre la rapidité et l'esthétique des lignes.
  • text-wrap-style: initial; (auto) text-wrap-style: inherit; text-wrap-style: revert; text-wrap-style: revertLayer; text-wrap-style: unset;

    Consultez les pages suivantes pour plus de détails : initial, inherit, revert, revert-layer, unset.

Exemple d'animation de text-wrap-style.

Le propriété text-wrap-style peut être animée de façon "discrète", ce qui veut dire que le passage d'une valeur à l'autre se fait brutalement.

Les retours à la ligne de ce texte varient en fonction de text-wrap-style.

Accéder à la propriété text-wrap-style par programme.

Avec Javascript, modifier la valeur de text-wrap-style.

En Javascript, voici comment modifier la valeur de text-wrap-style. On voit que Javascript propose une syntaxe avec la notation typique de CSS, en kebab-case, et une autre syntaxe avec la notation en camel-case.

Javascript
let el = document.getElementById('id'); el.style['text-wrap-style'] = 'balance'; // ou let el = document.getElementById('id'); el.style.textWrapStyle = 'balance';

Avec Javascript, lire la valeur de text-wrap-style.

La propriété doit avoir été affectée directement à l'élément lui-même via son attribut style, et non pas en passant par un sélecteur CSS.

Javascript
let el = document.getElementById('id'); let value = el.style['text-wrap-style']; // ou let el = document.getElementById('id'); let value = el.style.textWrapStyle;

Avec Javascript, lire la valeur calculée de text-wrap-style.

La valeur calculée est celle qui résulte de la cascade des héritages, ou à défaut, la valeur calculée est la valeur initiale (auto pour text-wrap-style).

Javascript
let el = document.getElementById('id'); let value = window.getComputedStyle(el).getPropertyValue('text-wrap-style');

Avec JQuery, modifier la valeur de text-wrap-style.

JQuery

$('#id').css('text-wrap-style', 'balance');
// ou
$('#id').css('textWrapStyle', 'balance');

Avec Javascript, lire la valeur de text-wrap-style.

JQuery
let value = $('#id').css('text-wrap-style');

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é text-wrap-style et affichent ensuite soit la valeur telle qu'elle a été appliquée, soit la valeur calculée. Dans le cas de text-wrap-style cela ne fera pas de différences.

Exemple interactif avec la propriété text-wrap-style.

Le simulateur agit sur un simple bloc de texte (en premier), et sur un conteneur regroupant plusieurs élément ayant reçu display:inline-block;.
Remarque : sur Firefox   le fonctionnement semble incorrect pour la valeur balance dans le cas d'une suite de blocs inline.

text-wrap-style :
Ce texte comporte des lignes qui seront coupées différemment suivant la valeur donnée à text-wrap-style.
Ce
conteneur
contient
un
bloc
inline
pour
chacun
des
mots

Compatibilité des navigateurs avec text-wrap-style.

La propriété text-wrap-style est maintenant bien reconnue pas les principaux navigateurs, même si le traitement de la valeur pretty laisse encore à désirer.

Colonne 1
Support par les navigateurs de la propriété text-wrap-style qui définit comment les retours à la ligne se font.
Colonne 2
Prise en charge par les navigateurs de la valeur pretty pour la propriété text-wrap-style.
1
Propriété
text-wrap-style
2
Valeur
pretty
Estimation de la prise en charge globale.
86%
70%

Navigateurs sur ordinateurs :

Navigateurs sur mobiles :

Navigateurs obsolètes ou marginaux :

Internet Explorer

UC Browser pour Androïd

Opéra Mobile

QQ Browser

Baidu Browser

Opéra

Chrome

Safari

Firefox

Safari sur IOS

Edge

Chrome pour Androïd

Samsung Internet

Androïd Brower

Firefox pour Androïd

KaiOS Browser

Opéra mini

Histoire de la propriété text-wrap-style.

Voir aussi, à propos des manipulations de texte.

La propriété text-wrap-style fait partie du module CSS Text Module.
Les définitions suivantes sont également décrites dans ce même module.

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.
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-spacing
Permet d'ajuster l'espacement des mots.
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.