Typography

Text Decoration Thickness

Utilities for controlling the thickness of text decorations.

Quick reference

Class
Properties
decoration-autotext-decoration-thickness: auto;
decoration-from-fonttext-decoration-thickness: from-font;
decoration-0text-decoration-thickness: 0px;
decoration-1text-decoration-thickness: 1px;
decoration-2text-decoration-thickness: 2px;
decoration-4text-decoration-thickness: 4px;
decoration-8text-decoration-thickness: 8px;

Basic usage

Setting the text decoration thickness

Use the decoration-{width} utilities to change the thickness of an element’s text decoration.

Text Decoration Thickness - 图1

  1. <p class="underline decoration-1 ...">The quick brown fox...</p>
  2. <p class="underline decoration-2 ...">The quick brown fox...</p>
  3. <p class="underline decoration-4 ...">The quick brown fox...</p>

Applying conditionally

Hover, focus, and other states

Tailwind lets you conditionally apply utility classes in different states using variant modifiers. For example, use hover:decoration-4 to only apply the decoration-4 utility on hover.

  1. <p class="underline hover:decoration-4">
  2. <!-- ... -->
  3. </p>

For a complete list of all available state modifiers, check out the Hover, Focus, & Other States documentation.

Breakpoints and media queries

You can also use variant modifiers to target media queries like responsive breakpoints, dark mode, prefers-reduced-motion, and more. For example, use md:decoration-4 to apply the decoration-4 utility at only medium screen sizes and above.

  1. <p class="underline md:decoration-4">
  2. <!-- ... -->
  3. </p>

To learn more, check out the documentation on Responsive Design, Dark Mode and other media query modifiers.


Using custom values

Customizing your theme

You can customize the decoration-{width} utilities by editing theme.textDecorationThickness or theme.extend.textDecorationThickness in your tailwind.config.js file.

tailwind.config.js

  1. module.exports = { theme: { extend: { textDecorationThickness: { 3: '3px', } } }}

Learn more about customizing the default theme in the theme customization documentation.

Arbitrary values

If you need to use a one-off text-decoration-thickness value that doesn’t make sense to include in your theme, use square brackets to generate a property on the fly using any arbitrary value.

  1. <p class="decoration-[3px]">
  2. <!-- ... -->
  3. </p>

Learn more about arbitrary value support in the arbitrary values documentation.