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;
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.
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-position
cannot be set, and therefore are not reset either, using the text-emphasis
shorthand property.
Formal definition
Initial value | over right |
---|---|
Applies to | all elements |
Inherited | no |
Computed value | as specified |
Animation type | discrete |
Formal syntax
[ over | under ] && [ right | left ]
Examples
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:
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
Specification | Status | Comment |
---|---|---|
CSS Text Decoration Module Level 3 The definition of 'text-emphasis' in that specification. |
Candidate Recommendation | Initial definition |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
text-emphasis-position | Chrome
Full support
25
| Edge
Full support
79
| Firefox
Full support
46
| IE No support No | Opera
Full support
15
| Safari
Full support
6.1
| WebView Android
Full support
4.4
| Chrome Android
Full support
25
| Firefox Android
Full support
46
| Opera Android
Full support
14
| Safari iOS
Full support
7
| Samsung Internet Android
Full support
1.5
|
left and right | Chrome Full support 62 | Edge Full support 79 | Firefox Full support 46 | IE No support No | Opera Full support 49 | Safari Full support 8 | WebView Android Full support 62 | Chrome Android Full support 62 | Firefox Android Full support 46 | Opera Android Full support 46 | Safari iOS Full support 8 | Samsung Internet Android Full support 8.0 |
Legend
- Full support
- Full support
- No support
- No support
- User must explicitly enable this feature.
- User must explicitly enable this feature.
- Requires a vendor prefix or different name for use.
- Requires a vendor prefix or different name for use.
See also
- The longhand properties
text-emphasis-style
,text-emphasis-color
, and the corresponding shorthand propertytext-emphasis
.