1. css
  2. /properties
  3. /text-decoration-skip

text-decoration-skip

Overview

The text-decoration-skip property intends to control how text decoration, such as underlines, overlines, or strike-throughs, skips or interrupts around certain elements or areas of text. However, its implementation and standardization have been inconsistent.

While some values of this property have been deprecated, the CSS Working Group (CSSWG) has not yet fully resolved its specifications. The industry seems to be gravitating towards the use of the text-decoration-skip-ink property, as a more straightforward approach.

Values

The CSSWG is considering splitting the functionality of text-decoration-skip into individual properties, much like how text-decoration-skip-ink has been singled out, with the aim to improve its cascading behavior.

As per the ongoing discussion, text-decoration-skip is proposed to accept the following values:

ValueDescription
noneIntended to set all sub-properties to none.
autoAimed to set all sub-properties to their initial values.

However, these definitions are not yet fully confirmed as the property is still under vetting. Current industry trends seem to favor the text-decoration-skip-ink property.

Associated Properties

  • text-decoration-skip-ink
  • text-decoration
  • text-decoration-line
  • text-decoration-style
  • text-decoration-color
  • text-decoration-thickness

Tips and Tricks

  • Using the text-decoration-skip in production environments is not recommended. Opt for text-decoration-skip-ink instead.

  • When using text-decoration-line with the values spelling-error or grammar-error, the User Agent (UA) may choose to overlook any associated properties like text-decoration-skip.

Browser Compatibility

Browser support for this property is highly limited. Most browsers are leaning toward supporting the text-decoration-skip-ink property. For specific details check out the links in the Useful Resources section below.

Useful Resources

text-decoration-skip-ink

Can I use: text-decoration-skip

W3C's Editor's Draft of CSS Text Decoration Module Level 4: text-decoration-skip