Arbitrary variants for custom selectors in Tailwind

Introduction

Arbitrary variants let you apply styles based on custom CSS selectors. This helps you style elements in special ways that Tailwind's default options don't cover.

You want to style an element only when a parent has a specific class.

You need to apply styles when an element is focused or hovered in a unique way.

You want to target elements based on attributes or states not included in Tailwind by default.

You want to write a quick custom selector without adding extra CSS files.

You want to style nested elements inside a component with a special condition.

Syntax

Tailwind

[&<custom-selector>]:<utility>

Use square brackets [] to wrap your custom selector inside the variant.

The ampersand & represents the current element in the selector.

Examples

Change background color to blue when the element is hovered.

Tailwind

[&:hover]:bg-blue-500

Make direct child paragraphs have red text.

Tailwind

[&>p]:text-red-600

Make the element bold if it has a data-active attribute set to true.

Tailwind

[&[data-active="true"]]:font-bold

Underline the element when it has the class 'custom-class'.

Tailwind

[&.custom-class]:underline

Sample Program

This example shows a button that changes background color when hovered using an arbitrary variant. The paragraph styles its first letter bigger and changes text color on hover using arbitrary variants.

Tailwind

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1" />
  <title>Arbitrary Variants Example</title>
  <script src="https://cdn.tailwindcss.com"></script>
</head>
<body class="p-6">
  <button class="[&:hover]:bg-green-300 border border-gray-400 px-4 py-2 rounded">
    Hover me
  </button>
  <div class="mt-4">
    <p class="[&:first-letter]:text-4xl [&:hover]:text-purple-700">
      This paragraph uses arbitrary variants to style its first letter and text color on hover.
    </p>
  </div>
</body>
</html>

Important Notes

Arbitrary variants let you write any CSS selector inside Tailwind's variant syntax.

Remember to use the ampersand & to refer to the current element inside your selector.

Use this feature to keep your styles in one place without extra CSS files.

Summary

Arbitrary variants let you style elements using custom CSS selectors inside Tailwind.

Wrap your selector in square brackets and use & to refer to the element.

They help you handle special styling cases without writing separate CSS.

Practice

1. What does an arbitrary variant in Tailwind CSS allow you to do?

easy

A. Use custom CSS selectors inside Tailwind classes

B. Write JavaScript code inside Tailwind classes

C. Change Tailwind's default color palette

D. Disable Tailwind's responsive features

Solution

1. Step 1: Understand Tailwind's arbitrary variants

   Arbitrary variants let you write custom CSS selectors inside Tailwind by wrapping them in square brackets.

2. Step 2: Compare options

   Only Use custom CSS selectors inside Tailwind classes correctly describes this feature; others describe unrelated Tailwind features.

3. Final Answer:

   Use custom CSS selectors inside Tailwind classes -> Option A

4. Quick Check:

   Arbitrary variants = custom selectors [OK]

Hint: Look for custom selector usage in square brackets [OK]

Common Mistakes:

• Thinking arbitrary variants change colors
• Confusing with JavaScript or responsive features
• Assuming it disables Tailwind features

2. Which of the following is the correct syntax to apply a hover style using an arbitrary variant in Tailwind?

easy

A. hover:[&:hover]:text-blue-500

B. [&:hover]:text-blue-500

C. hover:text-blue-500

D. [hover]:text-blue-500

Solution

1. Step 1: Understand arbitrary variant syntax

   Arbitrary variants use square brackets with a selector inside, e.g., [&:hover].

2. Step 2: Identify correct usage for hover

   [&:hover]:text-blue-500 uses the correct syntax: [selector]:utility, here [&:hover]:text-blue-500.

3. Final Answer:

   [&:hover]:text-blue-500 -> Option B

4. Quick Check:

   Arbitrary variant syntax = [&:hover]:utility [OK]

Hint: Look for square brackets with & and pseudo-class inside [OK]

Common Mistakes:

• Adding 'hover:' before arbitrary variant
• Using brackets without &
• Misplacing brackets around 'hover'

3. What will be the effect of this Tailwind class on a button element?

<button class="[&:focus-visible]:ring-2 [&:focus-visible]:ring-blue-600">Click me</button>

medium

A. The button never shows a ring

B. The button always has a blue ring

C. The button gets a blue ring when it is focused and visible

D. The button gets a blue ring only on hover

Solution

1. Step 1: Analyze the arbitrary variant selectors

   The class uses [&:focus-visible] which applies styles only when the button is focused and visible.

2. Step 2: Understand the applied styles

   ring-2 and ring-blue-600 add a blue outline ring of thickness 2 on focus-visible state.

3. Final Answer:

   The button gets a blue ring when it is focused and visible -> Option C

4. Quick Check:

   Arbitrary variant with :focus-visible = ring on focus [OK]

Hint: Focus-visible means ring appears only on keyboard focus [OK]

Common Mistakes:

• Thinking ring is always visible
• Confusing focus-visible with hover
• Ignoring the arbitrary variant selector

4. Identify the error in this Tailwind class usage:

<div class="[&hover]:bg-red-500">Alert</div>

medium

A. Incorrect pseudo-class syntax, should be [&:hover]

B. Square brackets should not be used here

C. Missing ampersand (&) before hover

D. bg-red-500 is not a valid Tailwind color

Solution

1. Step 1: Check the arbitrary variant syntax

   The pseudo-class hover must be preceded by a colon and ampersand inside brackets: [&:hover].

2. Step 2: Identify the mistake

   The class uses [&hover] missing the colon, so it is invalid syntax.

3. Final Answer:

   Incorrect pseudo-class syntax, should be [&:hover] -> Option A

4. Quick Check:

   Pseudo-class needs colon after & [OK]

Hint: Pseudo-classes need &: e.g., [&:hover] not [&hover] [OK]

Common Mistakes:

• Omitting colon before pseudo-class
• Using brackets incorrectly
• Assuming bg-red-500 is invalid

5. You want to style a child span inside a div only when the div is hovered, using Tailwind arbitrary variants. Which class should you add to the div?

hard

A. [&>span:hover]:text-green-600

B. [&>span]:hover:text-green-600

C. hover:[&>span]:text-green-600

D. [&:hover>span]:text-green-600

Solution

1. Step 1: Understand the selector goal

   You want to style the span child only when the div is hovered, so the hover is on the parent.

2. Step 2: Choose correct arbitrary variant syntax

   The selector [&:hover>span] means when the div is hovered, style its direct child span.

3. Step 3: Check other options

   [&>span:hover]:text-green-600 styles span on its own hover, not div's hover. hover:[&>span]:text-green-600 and D have incorrect syntax or order.

4. Final Answer:

   [&:hover>span]:text-green-600 -> Option D

5. Quick Check:

   Parent hover affecting child = [&:hover>span] [OK]

Hint: Parent hover affecting child uses [&:hover>child] [OK]

Common Mistakes:

• Applying hover on child instead of parent
• Misplacing brackets or colons
• Using hover: outside arbitrary variant incorrectly