W3cubDocs

/CSS

text-emphasis-position

The text-emphasis-position CSS property sets where emphasis marks are drawn. Like ruby text, if there isn't enough room for emphasis marks, 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;
Initial value over right
Applies to all elements
Inherited no
Media visual
Computed value as specified
Animation type discrete
Canonical order the unique non-ambiguous order defined by the formal grammar

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

Preferred emphasis mark and ruby position
Language Preferred position Illustration
Horizontal Vertical
Japanese over right Emphasis marks appear over each emphasized character in horizontal Japanese text. Emphasis marks appear on the right of each emphasized character in vertical Japanese text.
Mongolian
Chinese under right Emphasis marks appear below each emphasized character in horizontal Simplified Chinese text.

Note: The text-emphasis-position cannot be set, and therefore are not reset either, using the text-emphasis shorthand property.

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

Specification Status Comment
CSS Text Decoration Module Level 3
The definition of 'text-emphasis' in that specification.
Candidate Recommendation Initial definition

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support Yes
Yes
25
Prefixed
Prefixed Requires the vendor prefix: -webkit-
? 46
46
45 — 49
Disabled
Disabled From version 45 until version 49 (exclusive): this feature is behind the layout.css.text-emphasis.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
No Yes
Yes
15
Prefixed
Prefixed Requires the vendor prefix: -webkit-
Yes
Yes
6.1
Prefixed
Prefixed Requires the vendor prefix: -webkit-
left and right 62 ? 46 No 49 Yes
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support Yes
Yes
4.4
Prefixed
Prefixed Requires the vendor prefix: -webkit-
Yes ? 46
46
45 — 49
Disabled
Disabled From version 45 until version 49 (exclusive): this feature is behind the layout.css.text-emphasis.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Yes
Yes
33
Prefixed
Prefixed Requires the vendor prefix: -webkit-
? Yes
left and right 62 62 ? 46 49 ? No

See also

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/CSS/text-emphasis-position