<pre class="brush: css notranslate"><code><span class="token property">text-decoration</span><span class="token punctuation">:</span> underline<span class="token punctuation">;</span> <span class="token property">text-decoration</span><span class="token punctuation">:</span> overline red<span class="token punctuation">;</span> <span class="token property">text-decoration</span><span class="token punctuation">:</span> none<span class="token punctuation">;</span> <span class="token comment">/ Global values /</span> <span class="token property">text-decoration</span><span class="token punctuation">:</span> inherit<span class="token punctuation">;</span> <span class="token property">text-decoration</span><span class="token punctuation">:</span> initial<span class="token punctuation">;</span> <span class="token property">text-decoration</span><span class="token punctuation">:</span> revert<span class="token punctuation">;</span> <span class="token property">text-decoration</span><span class="token punctuation">:</span> unset<span class="token punctuation">;</span> </code></pre>

text-decoration

The text-decoration shorthand CSS property sets the appearance of decorative lines on text. It is a shorthand for text-decoration-line, text-decoration-color, text-decoration-style, and the newer text-decoration-thickness property.

Text decorations are drawn across descendant text elements. This means that if an element specifies a text decoration, then a child element can't remove the decoration. For example, in the markup <p>This text has <em>some emphasized words</em> in it.</p>, the style rule p { text-decoration: underline; } would cause the entire paragraph to be underlined. The style rule em { text-decoration: none; } would not cause any change; the entire paragraph would still be underlined. However, the rule em { text-decoration: overline; } would cause a second decoration to appear on "some emphasized words".

Constituent properties

This property is a shorthand for the following CSS properties:

Syntax

text-decoration: underline; text-decoration: overline red; text-decoration: none;  /* Global values */ text-decoration: inherit; text-decoration: initial; text-decoration: revert; text-decoration: unset; 

The text-decoration property is specified as one or more space-separated values representing the various longhand text-decoration properties.

Values

Sets the kind of decoration used, such as underline or line-through.

Sets the color of the decoration.

Sets the style of the line used for the decoration, such as solid, wavy, or dashed.

Sets the thickness of the line used for the decoration.

Formal definition

Formal syntax

<'text-decoration-line'> || <'text-decoration-style'> || <'text-decoration-color'> || <'text-decoration-thickness'>

Examples

Demonstration of text-decoration values

.under {   text-decoration: underline red; }  .over {   text-decoration: wavy overline lime; }  .line {   text-decoration: line-through; }  .plain {   text-decoration: none; }  .underover {   text-decoration: dashed underline overline; }  .thick {   text-decoration: solid underline purple 4px; }  .blink {   text-decoration: blink; } 

<p class="under">This text has a line underneath it.</p> <p class="over">This text has a line over it.</p> <p class="line">This text has a line going through it.</p> <p>This <a class="plain" href="#">link will not be underlined</a>,     as links generally are by default. Be careful when removing     the text decoration on anchors since users often depend on     the underline to denote hyperlinks.</p> <p class="underover">This text has lines above <em>and</em> below it.</p> <p class="thick">This text has a really thick purple underline in supporting browsers.</p> <p class="blink">This text might blink for you,     depending on the browser you use.</p> 

Specifications

See also