text-emphasis-position

The text-emphasis-position CSS property describes where emphasis marks are drawn at. The effect of emphasis marks on the line height is the same as for ruby text: if there isn't enough place, the line height is increased.

/* Initial value */
text-emphasis-position: over right;

/* Keywords value */
text-emphasis-position: over left;
text-emphasis-position: under right;
text-emphasis-position: under left;

text-emphasis-position: left over;
text-emphasis-position: right under;
text-emphasis-position: left under;

/* Global values */
text-emphasis-position: inherit;
text-emphasis-position: initial;
text-emphasis-position: unset;

Preferred position

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 and Japanese:

Syntax

Values

over

Draw marks over the text in horizontal writing mode.

under

Draw marks under the text in horizontal writing mode.

right

Draws marks to the right of the text in vertical writing mode.

left

Draw marks to the left of the text in vertical writing mode.

Formal syntax

[ over | under ] && [ right | left ]

Examples

Some editors prefer to hide emphasis marks when they conflict with ruby. In HTML, this can be done with the following style rule:

ruby {
  text-emphasis: none;
}

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

• The longhand properties text-emphasis-style, text-emphasis-color, and the corresponding shorthand property text-emphasis.