Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

text-emphasis-position — posição das marcas de ênfase

A propriedade text-emphasis-position seleciona o lado do texto onde aparecem as marcas de ênfase. Define posições distintas para os modos tipográficos horizontal e vertical; por si só, não ativa as marcas.

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

Sintaxe

text-emphasis-position: [ over | under ] && [ right | left ]?;

text-emphasis-position controla a posição das marcas de ênfase usadas, por exemplo, na tipografia do leste asiático. Para que as marcas fiquem visíveis, define também text-emphasis-style ou a propriedade abreviada text-emphasis, uma vez que o estilo inicial é none.

É obrigatório indicar um dos valores over e under: nos modos tipográficos horizontais, colocam as marcas acima ou abaixo do texto, respetivamente. O valor opcional right ou left seleciona o lado nos modos verticais. Se esta parte for omitida, aplica-se right; left sozinho é inválido. As duas partes podem surgir em qualquer ordem.

O valor inicial é over right. A propriedade é herdada e a abreviatura text-emphasis não a repõe. A animação é discreta, sem deslocação gradual das marcas.

O exemplo aplica under left a ambos os parágrafos: o horizontal demonstra under, enquanto o vertical demonstra left. Não se trata de um sublinhado feito com text-decoration. A posição pode ser ajustada para evitar conflitos com decorações de sublinhado ou de sobrelinhado.

Exemplos

<!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>

Resultado

horizontal-tb: marks below (text-emphasis-position: under left)
vertical-rl: marks to the left (text-emphasis-position: under left)

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes