Peer modifier (sibling state reaction) in Tailwind

Introduction

The peer modifier lets one element change style when its sibling changes state, like when a checkbox is checked.

You want a label to highlight when its checkbox is checked.

You want to show or hide a message when a related input is focused.

You want a button to change color when a nearby toggle is active.

You want to style a sibling element based on a form control's state.

Syntax

Tailwind

peer:[state]:[utility]

The element that changes state must have the class peer.

The sibling uses peer- prefix to react to that state.

Examples

The label text turns blue when the checkbox is checked.

Tailwind

<input type="checkbox" class="peer" />
<label class="peer-checked:text-blue-600">Check me</label>

The div background changes when the radio button is selected.

Tailwind

<input type="radio" class="peer" />
<div class="peer-checked:bg-green-200">Selected</div>

The paragraph text turns red when the input is focused.

Tailwind

<input type="text" class="peer" />
<p class="peer-focus:text-red-500">Input is focused</p>

Sample Program

This example has a hidden checkbox with class peer. The label changes background and text color when the checkbox is checked. The sibling span text color also changes using peer-checked.

Tailwind

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1" />
  <title>Peer Modifier Example</title>
  <script src="https://cdn.tailwindcss.com"></script>
</head>
<body class="flex flex-col items-center justify-center min-h-screen bg-gray-50 p-4">
  <h1 class="text-2xl font-semibold mb-4">Peer Modifier Demo</h1>
  <div class="flex items-center space-x-3">
    <input type="checkbox" id="toggle" class="peer hidden" />
    <label for="toggle" class="cursor-pointer px-4 py-2 border rounded peer-checked:bg-blue-600 peer-checked:text-white">
      Toggle Me
    </label>
    <span class="text-gray-700 peer-checked:text-blue-600">
      Status changes when toggle is checked
    </span>
  </div>
</body>
</html>

Important Notes

The peer class must be on the element whose state you want to watch.

Only siblings after the peer element can react to its state.

This works well for inputs like checkboxes, radios, and focus states.

Summary

The peer modifier lets one element style its siblings based on its state.

Use peer on the element changing state, and peer-* on siblings reacting.

This helps create interactive UI without JavaScript.

Practice

1. What does the peer modifier in Tailwind CSS allow you to do?

easy

A. Add margin to an element when it is focused.

B. Style sibling elements based on the state of the element with peer.

C. Change the color of the element itself on hover.

D. Create animations on the element when clicked.

Solution

1. Step 1: Understand the role of peer

   The peer modifier is used on an element to mark it as a reference for sibling elements.

2. Step 2: Recognize sibling styling with peer-*

   Siblings can then use peer-* classes to change their style based on the peer element's state.

3. Final Answer:

   Style sibling elements based on the state of the element with peer. -> Option B

4. Quick Check:

   Peer modifier = sibling state styling [OK]

Hint: Peer lets siblings react to one element's state [OK]

Common Mistakes:

• Thinking peer styles the element itself
• Confusing peer with hover or focus on the same element
• Assuming peer adds animations automatically

2. Which of the following is the correct way to use the peer modifier in Tailwind CSS?

easy

A. <input type='checkbox' class='peer' /><label class='peer-checked:text-blue-500'>Check me</label>

B. <input type='checkbox' class='peer-checked' /><label class='peer:text-blue-500'>Check me</label>

C. <input type='checkbox' class='checked-peer' /><label class='text-blue-500'>Check me</label>

D. <input type='checkbox' class='peer' /><label class='checked-peer:text-blue-500'>Check me</label>

Solution

1. Step 1: Identify correct usage of peer on the input

   The element that changes state (checkbox) must have the class peer.

2. Step 2: Use peer-checked on sibling label

   The sibling uses peer-checked: prefix to style based on the checkbox state.

3. Final Answer:

   <input type='checkbox' class='peer' /><label class='peer-checked:text-blue-500'>Check me</label> -> Option A

4. Quick Check:

   Peer on input, peer-checked on sibling [OK]

Hint: Put peer on state element, peer-* on siblings [OK]

Common Mistakes:

• Using peer-checked on the input instead of sibling
• Mixing up class names like checked-peer
• Not adding peer class to the element changing state

3. Given this HTML snippet, what color will the <span> text be when the checkbox is checked?

<input type='checkbox' class='peer' id='toggle' />
<span class='peer-checked:text-green-600'>Status</span>

medium

A. The text will be blue when checked.

B. The text will be red when checked.

C. The text will be green (#16a34a) when checked.

D. The text color will not change on check.

Solution

1. Step 1: Check the peer class on checkbox

   The checkbox has class peer, so siblings can react to its state.

2. Step 2: Analyze the sibling span's class

   The span uses peer-checked:text-green-600, so when checkbox is checked, text color changes to green.

3. Final Answer:

   The text will be green (#16a34a) when checked. -> Option C

4. Quick Check:

   peer-checked:text-green-600 means green text on check [OK]

Hint: peer-checked changes sibling style on checked state [OK]

Common Mistakes:

• Assuming text changes color without peer class
• Confusing green-600 with red or blue
• Ignoring that peer must be on the input

4. Why does this code NOT change the sibling paragraph's text color when the checkbox is checked?

<input type='checkbox' id='check' class='checked' />
<p class='peer-checked:text-red-500'>Warning</p>

medium

A. Because the 'checked' class on input does not trigger sibling styles; only 'peer' does.

B. Because the input has both 'checked' and 'peer' classes, which is invalid.

C. Because the 'checked' class on input is incorrect; it should be 'peer-checked'.

D. Because the 'peer' class must be alone without other classes.

Solution

1. Step 1: Understand the role of 'peer' and 'checked'

   The 'peer' class marks the element for sibling state detection. 'checked' is not a valid Tailwind class for inputs.

2. Step 2: Identify why sibling styles don't apply

   The sibling uses 'peer-checked', which reacts to the input's checked state only if the input has 'peer' class. 'checked' class on input does nothing.

3. Final Answer:

   Because the 'checked' class on input does not trigger sibling styles; only 'peer' does. -> Option A

4. Quick Check:

   Only 'peer' triggers sibling state styles [OK]

Hint: Only 'peer' triggers sibling styles, not 'checked' class [OK]

Common Mistakes:

• Thinking 'checked' class triggers styles
• Assuming multiple classes break peer
• Confusing 'checked' class with input state

5. You want a button's background to turn blue only when a checkbox sibling is focused or checked. Which Tailwind classes correctly achieve this?

<input type='checkbox' class='peer' />
<button class='???'>Submit</button>

hard

A. peer-checked:bg-blue-600 focus-within:bg-blue-600

B. checked:bg-blue-600 focus:bg-blue-600

C. peer:bg-blue-600 peer-checked:bg-blue-600

D. peer-checked:bg-blue-600 peer-focus:bg-blue-600

Solution

1. Step 1: Identify the states to react to on the checkbox

   The checkbox can be checked or focused. We want the button to change background in both cases.

2. Step 2: Use correct peer modifiers on the button

   Use peer-checked:bg-blue-600 for checked state and peer-focus:bg-blue-600 for focus state on the sibling button.

3. Final Answer:

   peer-checked:bg-blue-600 peer-focus:bg-blue-600 -> Option D

4. Quick Check:

   Use peer-checked and peer-focus for sibling states [OK]

Hint: Combine peer-checked and peer-focus for sibling states [OK]

Common Mistakes:

• Using focus:bg-blue-600 instead of peer-focus
• Using checked:bg-blue-600 without peer prefix
• Confusing focus-within with peer-focus