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;
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 and Japanese:
Language | Preferred position | Illustration | ||
---|---|---|---|---|
Horizontal | Vertical | |||
Japanese | over | right | ||
Mongolian | ||||
Chinese | under | right |
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 compatibility
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | Yes 25 -webkit- | ? | 46 45 — 491 | No | Yes 15 -webkit- | Yes 6.1 -webkit- |
left and right | 62 | ? | 46 | No | 49 | Yes |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic support | Yes 4.4 -webkit- | Yes | ? | 46 45 — 491 | No | Yes 33 -webkit- | ? |
left and right | 62 | 62 | ? | 46 | ? | 49 | ? |
1. 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.
See also
- The longhand properties
text-emphasis-style
,text-emphasis-color
, and the corresponding shorthand propertytext-emphasis
.