text-emphasis

The text-emphasis CSS property applies emphasis marks to text (except spaces and control characters). It is a shorthand for text-emphasis-style and text-emphasis-color.

Try it

text-emphasis: none;

text-emphasis: filled red;

text-emphasis: "x";

text-emphasis: filled double-circle #ffb703;

<section id="default-example">
 <p>
 I'd far rather be
 <span class="transition-all" id="example-element">happy than right</span>
 any day.
 </p>
</section>

p {
 font: 1.5em sans-serif;
}

The text-emphasis property is quite different from text-decoration. The text-decoration property does not inherit, and the decoration specified is applied across the whole element. However, text-emphasis does inherit, which means it is possible to change emphasis marks for descendants.

The size of the emphasis symbol, like ruby symbols, is about 50% of the size of the font, and text-emphasis may affect line height when the current leading is not enough for the marks.

Constituent properties

This property is a shorthand for the following CSS properties:

• text-emphasis-color
• text-emphasis-style

Syntax

/* Initial value */
text-emphasis: none; /* No emphasis marks */
/* <string> value */
text-emphasis: "x";
text-emphasis: "点";
text-emphasis: "25円B2";
text-emphasis: "*" #555555;
text-emphasis: "foo"; /* Should NOT use. It may be computed to or rendered as 'f' only */
/* Keywords value */
text-emphasis: filled;
text-emphasis: open;
text-emphasis: filled sesame;
text-emphasis: open sesame;
/* Keywords value combined with a color */
text-emphasis: filled sesame #555555;
/* Global values */
text-emphasis: inherit;
text-emphasis: initial;
text-emphasis: revert;
text-emphasis: revert-layer;
text-emphasis: unset;

Values

none

No emphasis marks.

filled

The shape is filled with solid color. If neither filled nor open is present, this is the default.

open

The shape is hollow.

dot

Display small circles as marks. The filled dot is '•' (U+2022), and the open dot is '◦' (U+25E6).

circle

Display large circles as marks. The filled circle is '●くろまる' (U+25CF), and the open circle is '○しろまる' (U+25CB). This is the default shape in horizontal writing modes when no other shape is given.

double-circle

Display double circles as marks. The filled double-circle is '◉' (U+25C9), and the open double-circle is '◎にじゅうまる' (U+25CE).

triangle

Display triangles as marks. The filled triangle is '▲さんかく' (U+25B2), and the open triangle is '△しろさんかく' (U+25B3).

sesame

Display sesames as marks. The filled sesame is '﹅' (U+FE45), and the open sesame is '﹆' (U+FE46). This is the default shape in vertical writing modes when no other shape is given.

<string>

Display the given string as marks. Authors should not specify more than one character in <string>. The UA may truncate or ignore strings consisting of more than one grapheme cluster.

<color>

Defines the color of the mark. If no color is present, it defaults to currentColor.

Formal definition

Formal syntax

text-emphasis = 
 <'text-emphasis-style'> || 
 <'text-emphasis-color'> 

<text-emphasis-style> = 
 none | 
 [ [ filled | open ] || [ dot | circle | double-circle | triangle | sesame ] ] | 
 <string> 

<text-emphasis-color> = 
 <color> 

Examples

A heading with emphasis shape and color

This example draws a heading with triangles used to emphasize each character.

CSS

h2 {
 text-emphasis: triangle #dd5555;
}

HTML

<h2>This is important!</h2>

Result

Specifications

Browser compatibility

See also

• The longhand properties text-emphasis-style, text-emphasis-color.
• The text-emphasis-position property allowing to define the position of the emphasis marks.