CKTIS / CSS
text-emphasis-position — position des marques d’emphase
La propriété text-emphasis-position choisit le côté du texte où apparaissent les marques d’emphase. Elle définit des positions distinctes pour les modes typographiques horizontal et vertical ; elle n’active pas les marques à elle seule.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
text-emphasis-position: [ over | under ] && [ right | left ]?;text-emphasis-position contrôle le placement des marques d’emphase utilisées, par exemple, en typographie est-asiatique. Pour que les marques soient visibles, définissez également text-emphasis-style ou la propriété raccourcie text-emphasis, car le style initial est none.
L’une des valeurs over et under est obligatoire : dans les modes typographiques horizontaux, elles placent les marques respectivement au-dessus ou au-dessous du texte. La valeur facultative right ou left sélectionne le côté dans les modes verticaux. Si cette partie est omise, right s’applique ; left seul n’est pas valide. Les deux parties peuvent apparaître dans n’importe quel ordre.
La valeur initiale est over right. La propriété est héritée et n’est pas réinitialisée par la propriété raccourcie text-emphasis. L’animation est discrète, sans déplacement progressif des marques.
L’exemple applique under left aux deux paragraphes : le paragraphe horizontal illustre under, tandis que le paragraphe vertical illustre left. Il ne s’agit pas d’un soulignement créé avec text-decoration. Le placement peut être ajusté pour éviter les conflits avec les décorations de soulignement ou de surlignement.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Text emphasis position</title>
<style>
.sample {
font: 32px/2 sans-serif;
text-emphasis-style: filled circle;
text-emphasis-position: under left;
}
#horizontal { writing-mode: horizontal-tb; }
#vertical { writing-mode: vertical-rl; }
</style>
</head>
<body>
<h2>Horizontal text</h2>
<p id="horizontal" class="sample" lang="ja">日本語</p>
<h2>Vertical text</h2>
<p id="vertical" class="sample" lang="ja">日本語</p>
<script>
for (const id of ['horizontal', 'vertical']) {
const style = getComputedStyle(document.getElementById(id));
const positions = style.textEmphasisPosition.split(/\s+/);
const horizontal = style.writingMode === 'horizontal-tb';
const keyword = positions.find(value => horizontal ? /^(over|under)$/.test(value) : /^(left|right)$/.test(value));
const side = { over: 'above', under: 'below', left: 'to the left', right: 'to the right' }[keyword];
console.log(`${style.writingMode}: ${style.textEmphasisStyle !== 'none' && side ? `marks ${side}` : 'no placement verified'} (text-emphasis-position: ${style.textEmphasisPosition})`);
}
</script>
</body>
</html>Résultat
horizontal-tb: marks below (text-emphasis-position: under left) vertical-rl: marks to the left (text-emphasis-position: under left)
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.