Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

text-underline-position — position du soulignement

La propriété text-underline-position contrôle la position d’un soulignement par rapport au texte. Elle permet un positionnement automatique, l’utilisation des métriques de la police et le choix du côté en composition verticale.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

text-underline-position: auto | [ from-font | under ] || [ left | right ];

text-underline-position définit la position d’un soulignement, mais ne l’active pas : utilisez text-decoration: underline. Sa valeur initiale est auto ; la propriété est héritée et n’est pas réinitialisée par le raccourci text-decoration.

auto laisse le navigateur choisir la position. from-font utilise les métriques appropriées de la première police disponible et revient à auto si elles sont absentes. under place la ligne sous le texte, généralement sous les jambages descendants, sans toutefois garantir l’absence de chevauchement.

left et right sélectionnent un côté en composition verticale ; en composition horizontale, ils sont traités comme auto. L’un ou l’autre peut accompagner under ou from-font, par exemple under right. La notation || signifie qu’un groupe ou les deux peuvent apparaître dans n’importe quel ordre ; auto s’utilise seul.

La propriété contrôle les décorations provenant de l’élément lui-même, et non celles de ses ancêtres. Elle définit également la position zéro de text-underline-offset, qui permet de déplacer davantage la ligne.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Underline position</title>
<style>
  p { font: 32px/1.8 sans-serif; text-decoration: underline; }
  .auto { text-underline-position: auto; }
  .under { text-underline-position: under; }
</style>
<p class="auto">auto: gypq</p>
<p class="under">under: gypq</p>
</html>

Résultat

Two underlined lines: "auto: gypq" and "under: gypq". The second uses under positioning; exact pixel positions depend on the font and browser.

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources