`text-emphasis-position` CSS property
The text-emphasis-position CSS property sets where emphasis marks are drawn. Similar to the text rendered by the <ruby> HTML element, if there isn't enough room for emphasis marks, the line height is increased.
The text-emphasis-position CSS property sets where emphasis marks are drawn. Similar to the text rendered by the <ruby> HTML element, if there isn't enough room for emphasis marks, the line height is increased.
CSS Demo: text-emphasis-position
```css interactive-example-choice text-emphasis-position: auto;
```css interactive-example-choice
text-emphasis-position: over right;
```css interactive-example-choice text-emphasis-position: under right;
```css interactive-example-choice
text-emphasis-position: auto;
writing-mode: vertical-rl;
```css interactive-example-choice text-emphasis-position: over left; writing-mode: vertical-rl;
```css interactive-example-choice
text-emphasis-position: over right;
writing-mode: vertical-rl;
```html interactive-example
I'd far rather be happy than right any day.
```css interactive-example
p {
font: 1.5em sans-serif;
}
#example-element {
text-emphasis: filled double-circle #ffb703;
}
Syntax
/* Initial value */
text-emphasis-position: auto;
/* Keyword values */
text-emphasis-position: over;
text-emphasis-position: under;
text-emphasis-position: over right;
text-emphasis-position: over left;
text-emphasis-position: under right;
text-emphasis-position: under left;
text-emphasis-position: left over;
text-emphasis-position: right over;
text-emphasis-position: right under;
text-emphasis-position: left under;
/* Global values */
text-emphasis-position: inherit;
text-emphasis-position: initial;
text-emphasis-position: revert;
text-emphasis-position: revert-layer;
text-emphasis-position: unset;
Values
The property accepts one or two values:
- If only one value is provided, it can be
auto,over, orunder. When onlyoverorunderis used,rightis assumed as the default position. - If two values are provided, they must include one of
overorunderand one ofrightorleft. Their order does not matter.
The values include:
auto- : Draws marks over the text in horizontal writing mode and to the right of the text in vertical writing mode.
over- : Draws marks over the text in horizontal writing mode.
under- : Draws marks under the text in horizontal writing mode.
right- : Draws marks to the right of the text in vertical writing mode.
left- : Draws marks to the left of the text in vertical writing mode.
Description
The preferred position of emphasis marks depends on the language. In Japanese for example, the preferred position is over right. In Chinese, on the other hand, the preferred position is under right. The informative table below summarizes the preferred emphasis mark positions for Chinese, Mongolian and Japanese:
| Language | Preferred position | Illustration | ||
|---|---|---|---|---|
| Horizontal | Vertical | |||
| Japanese | over | right |
|
|
| Korean | ||||
| Mongolian | ||||
| Chinese | under | right |
|
|
[!NOTE] The
text-emphasis-positioncannot be set, and therefore are not reset either, using the text-emphasis shorthand property.
Formal definition
Formal syntax
Examples
Adding emphasis mark positions
Use the dropdown menu to change the position of the emphasis marks. This will change the class on the <section> element, which in turn, will update the position of the emphasis marks on the text.
HTML
```html hidden
The auto value is not supported in your browser.
```html
<section id="setting" class="auto">
<p class="horizontal" lang="zh">你好世界</p>
<!-- Hello World in Chinese -->
<p class="vertical" lang="ja">世界、こんにちは。</p>
<!-- Hello World in Japanese -->
</section>
CSS
```css hidden .unsupported { color: red; } @supports (text-emphasis-position: auto) { .unsupported { display: none; } } .horizontal { writing-mode: horizontal-tb; } .vertical { writing-mode: vertical-rl; } section { display: flex; justify-content: space-around; }
```css
section p {
text-emphasis: filled circle tomato;
text-emphasis-position: auto;
}
.over-right p,
.preferred p [lang="ja"] {
text-emphasis-position: over right;
}
.over-left p {
text-emphasis-position: over left;
}
.under-right p,
.preferred p [lang="zh"] {
text-emphasis-position: under right;
}
.under-left p {
text-emphasis-position: under left;
}
.preferred p [lang="ja"] {
}
```js hidden const position = document.querySelector("#position"); const setting = document.querySelector("#setting"); const updateClass = () => { const currentClass = setting.classList; setting.classList.replace(currentClass, position.value); }; position.addEventListener("change", updateClass);
#### Result
Use the "Emphasis position" dropdown to choose the location of the emphasis marks. The `preferred` option in the dropdown uses the preferred positions, as explained in the [Description](#description) section.
450
### Preferring ruby over emphasis marks
Some editors prefer to hide emphasis marks when they conflict with ruby. In HTML, this can be done with the following style rule:
```css
ruby {
text-emphasis: none;
}
Preferring emphasis marks over ruby
Some other editors prefer to hide ruby when they conflict with emphasis marks. In HTML, this can be done with the following pattern:
em {
text-emphasis: dot; /* Set text-emphasis for <em> elements */
}
em rt {
display: none; /* Hide ruby inside <em> elements */
}
Specifications
Browser compatibility
See also
- text-underline-position
- text-emphasis-style
- text-emphasis-color
- text-emphasis shorthand property
- writing-mode