Borders

Outline Style

Utilities for controlling the style of an element’s outline.

Quick reference

Class
Properties
outline-noneoutline: 2px solid transparent; outline-offset: 2px;
outlineoutline-style: solid;
outline-dashedoutline-style: dashed;
outline-dottedoutline-style: dotted;
outline-doubleoutline-style: double;
outline-hiddenoutline-style: hidden;

Basic usage

Setting the outline style

Use the outline-{style} utilities to change the style of an element’s outline.

Outline Style - 图1

  1. <button class="outline outline-2 outline-offset-2 ...">Button A</button>
  2. <button class="outline-dashed outline-2 outline-offset-2 ...">Button B</button>
  3. <button class="outline-dotted outline-2 outline-offset-2 ...">Button C</button>
  4. <button class="outline-double outline-3 outline-offset-2 ...">Button D</button>

Removing outlines

Use outline-none to hide the default browser outline on focused elements.

It is highly recommended to apply your own focus styling for accessibility when using this utility.

Outline Style - 图2

Focus the input to see the expected behaviour

Outline Style - 图3

  1. <input type="text"
  2. placeholder="Default focus style"
  3. class="..." />
  4. <input type="text"
  5. placeholder="Custom focus style"
  6. class="focus:outline-none focus:ring focus:border-blue-500 ..." />

The outline-none utility is implemented using a transparent outline under the hood to ensure elements are still visibly focused to Windows high contrast mode users.


Applying conditionally

Hover, focus, and other states

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

  1. <div class="outline hover:outline-dashed">
  2. <!-- ... -->
  3. </div>

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:outline-dashed to apply the outline-dashed utility at only medium screen sizes and above.

  1. <div class="outline md:outline-dashed">
  2. <!-- ... -->
  3. </div>

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