Text-underline-position - Propriété CSS

text-underline-position

Résumé des caractéristiques de la propriété text-underline-position

Description rapide
Définit l'emplacement des traits de soulignement.
Statut
Standard
S'applique à
Tous les éléments.
Utilisable sur
HTML, SVG
Valeurs prédéfinies
auto | from-font | under | left | right
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-underline-position passe d'une valeur à l'autre sans transition.
Module W3C
Module CSS - Décoration du texte
Références (W3C)
 🡇  
 🡅  
Statut du document: WD (document de travail)

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

Syntaxe de text-underline-position (schéma).

text-underline-position - Syntax DiagramSyntax diagram of the text-underline-position CSS property. auto auto under under from-font from-font left left right righttext-underline-position:;text-underline-position:;
Schéma syntaxique de la propriété text-underline-position.
Détails sur les valeurs. Télécharger le schéma en SVG

Description de la propriété text-underline-position.

text-underline-position définit l'emplacement des traits de soulignement. Est-ce qu'ils coupent les jambages ? Sont ils en dessous des jambages ? Etc.

D'autre part, text-underline-position définit la référence pour text-underline-offset, une autre propriété qui gère la positionnement au pixel près des traits de soulignement.

Pour savoir comment activer le soulignement, reportez-vous aux propriétés text-decoration et text-decoration-line.

Mécanisme d'héritage.

Conformément au mécanisme d'héritage particulier aux décorations, text-underline-position agit sur le soulignement défini sur l'élément lui-même et pas sur le soulignement défini sur un élément parent. Ce fonctionnement produit parfois des résultats surprenants comme dans l'exemple ci-après où le trait de soulignement apparaît deux fois.

Sur ce point précis, tous les navigateurs ne réagissent pas de la même façon. Sur Chrome par exemple, l'exemple ci-dessous n'est pas conforme à la description que nous donnons.

Reportez-vous à la page sur text-decoration pour des explications plus précises sur la propagation des décorations aux éléments enfants.

Le soulignement est défini sur le parent et se retrouve sur l'élément enfant, mais la propriété text-underline-position appliquée sur l'élément enfant n'a aucun effet, car le soulignement a été défini sur le parent.

 
Parent
Enfant
Dans ce deuxième exemple, le soulignement a été défini sur le parent ET sur l'enfant, dans des couleurs différentes. La propriété text-underline-position appliquée sur l'élément enfant agit uniquement sur le soulignement défini sur cet élément, et pas le soulignement obtenu du parent.
Parent
Enfant

Valeurs pour text-underline-position.

  • text-underline-position: auto;

    Le navigateur décide de l'emplacement des traits de soulignement. En général, ils se positionnent au plus proche de la ligne de base du texte.

    Texte souligné
    text-underline-position:auto;
  • text-underline-position: from-font;

    Si la police de caractères utilisée comporte une indication sur l'emplacement des soulignement, utiliser cette information, sinon positionner le soulignement comme avec la valeur auto.

    Texte souligné
    text-underline-position:from-font;
  • text-underline-position: under;

    Le soulignement est positionné en plus bas, en dessous des jambages.
    Note : certaines polices fantaisie peuvent avoir des jambages qui descendent très bas, et coupent malgré tout le trait de soulignement.

    Au sujet des interactions entre le trait de soulignement et les jambages, voyez aussi la propriété text-decoration-skip-ink.

    Texte souligné
    text-underline-position:under;
  • text-underline-position: left; text-underline-position: right;

    Dans le cas des langues qui s'écrivent verticalement (langes CJK, hébreu, etc.), le trait de soulignement est placé à gauche ou à droite du texte. Ces valeurs sont équivalentes à auto pour les langues qui s'écrivent horizontalement.

    Ces valeurs sont cumulables avec from-font et under.

    Souligné
    text-underline-position:left;
    Souligné
    text-underline-position:right;
  • text-underline-position: above; Internet Explorer   text-underline-position: below; Internet Explorer  

    Le navigateur Internet Explorer interprète la propriété text-underline-position un peu différemment. Ces deux valeurs en particulier, qui permettent de positionner le trait de soulignement au dessus ou en dessous du texte, sont en conflit avec le nom de la propriété (underline veut clairement dire "en dessous de la ligne" en anglais).

  • text-underline-position: initial; (auto) text-underline-position: inherit; text-underline-position: revert; text-underline-position: revertLayer; text-underline-position: unset;

    Liens vers la présentation de ces différentes valeurs : initial, inherit, revert, revert-layer, unset.

Possibilité d'animation de la propriété text-underline-position.

L'animation de la propriété text-underline-position présentée ci-dessous, explore toutes les valeurs de text-underline-position valides pour un texte écrit horizontalement.

Position du soulignement

Simulateur avec la propriété text-underline-position.

Le simulateur présente un échantillon en police Arial et dans une police Google nommée Water Brush. La différence sera sensible pour la valeur under : avec une police de caractères classique comme Arial, le soulignement se positionne en dessous des jambages, mais avec la police fantaisie Water Brush le soulignement coupe malgré tout les jambages.


Mode d'écriture :

text-underline-position :

Texte souligné

Texte souligne (police Water Brush (google)

Support de text-underline-position.

Colonne 1
Support par les navigateurs de la propriété text-underline-position, qui définit si les traits de soulignement coupent les jambages des caractères.
Colonne 2
Support de la valeur from-font pour la propriété text-underline-position.
Colonne 3
Support des valeurs left et right pour la propriété text-underline-position.
1
Propriété
text-underline-position
2
Valeur
from-font
3
Valeurs
left
right
Estimation de la prise en charge globale.
96%
94%
89%

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

Samsung Internet

Edge

Safari

Opéra

Safari sur IOS

Androïd Brower

Firefox pour Androïd

Chrome

Firefox

Chrome pour Androïd

KaiOS Browser

Opéra mini

Évolution de la propriété text-underline-position.

Voir aussi, au sujet des décorations de texte.

Les spécifications CSS éditées par le W3C sont organisées en modules. La propriété text-underline-position fait partie du module de spécifications CSS Text Decoration Module. Les définitions suivantes sont également décrites dans ce module.

Propriétés :

text-decoration
Propriété résumée permettant de définir l'essentiel des paramètres de décoration de texte (couleur, type de trait...).
text-decoration-color
Définit la couleur du trait de décoration (souligné, rayure...).
text-decoration-line
Définit le type de décoration : souligné, barré, etc.
text-decoration-skip
Propriété raccourcie définissant ce que les traits de décoration doivent sauter (espaces, jambage, etc.).
text-decoration-skip-box
Définit comment les décorations héritées des éléments parents doivent être appliquées.
text-decoration-skip-ink
Définit si les lignes de décoration (essentiellement le souligné) s'interrompent au niveau des jambages.
text-decoration-skip-inset
Définit comment les décorations de l'élément lui même (et non pas celles des éléments parents) doivent être appliquées.
text-decoration-skip-self
Définit si les décoration du ou des éléments parents doivent être appliquées à cet élément.
text-decoration-skip-spaces
Définit si les lignes de décoration (soulignement, rayure...) concernent les espaces.
text-decoration-style
Type de trait pour la décoration : plein, pointillé, etc.
text-decoration-thickness
Définit l'épaisseur des traits de décoration (souligné, barré, surligné).
text-emphasis
Propriété résumée qui définit tous les paramètres de la mise en exergue d'un texte.
text-emphasis-color
Définit la couleur des caractères de mise en exergue.
text-emphasis-position
Définit la position des caractères de mise en exergue.
text-emphasis-skip
Définit si les mises en exergue doivent s'interrompre sur les espaces, les signes de ponctuation, etc.
text-emphasis-style
Spécifie le style de mise en exergue.
text-shadow
Cette propriété résumée définit tous les paramètres de l'ombre appliquée au texte : couleur, décalage, etc.).
text-underline-offset
Définit la position du trait de soulignement, par rapport à la position de base.