Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

text-emphasis-position — położenie znaków wyróżnienia

Właściwość text-emphasis-position określa stronę tekstu, po której pojawiają się znaki wyróżnienia. Osobno wybiera położenie dla poziomego i pionowego trybu typograficznego; sama nie włącza znaków.

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

Składnia

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

text-emphasis-position ustala położenie znaków wyróżnienia używanych m.in. w typografii wschodnioazjatyckiej. Aby znaki były widoczne, ustaw także text-emphasis-style lub skrót text-emphasis, ponieważ początkowy styl to none.

Wymagane jest jedno z over i under: w poziomym trybie typograficznym umieszczają znaki odpowiednio nad tekstem lub pod nim. Opcjonalne right albo left określa stronę w trybie pionowym. Pominięcie tej części oznacza right; samo left jest niepoprawne. Obie części można zapisać w dowolnej kolejności.

Wartość początkowa to over right. Właściwość jest dziedziczona, a skrót text-emphasis jej nie resetuje. Animacja jest dyskretna, bez płynnego przesuwania znaków.

Przykład stosuje under left w obu akapitach: poziomy pokazuje wybór under, pionowy — left. Nie jest to podkreślenie z text-decoration. Położenie może zostać skorygowane przy kolizji z podkreśleniem lub nadkreśleniem.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła