Class-based dark mode strategy in Tailwind - Performance & Optimization

Performance: Class-based dark mode strategy

MEDIUM IMPACT

This affects page load speed and rendering performance by controlling when and how dark mode styles are applied.

Implementing dark mode toggle with Tailwind CSS

Tailwind

/* Using class-based dark mode */
@tailwind base;
@tailwind components;
@tailwind utilities;

/* Tailwind config: darkMode: 'class' */

<body class="dark">
  <div class="bg-white dark:bg-gray-900 text-black dark:text-white">
    Hello World
  </div>
</body>

Dark mode styles apply only when the 'dark' class is present, avoiding unnecessary style recalculations on load.

📈 Performance GainSingle style calculation on load, no forced reflow from media query changes

Implementing dark mode toggle with Tailwind CSS

Tailwind

/* Using media query dark mode */
@tailwind base;
@tailwind components;
@tailwind utilities;

/* Tailwind config: darkMode: 'media' */

<body>
  <div class="bg-white dark:bg-gray-900 text-black dark:text-white">
    Hello World
  </div>
</body>

Dark mode styles are applied based on user system preferences, causing a flash of incorrect theme if user toggles manually later.

📉 Performance CostTriggers style recalculation on initial load and possible reflow if user changes system theme

Performance Comparison

Pattern	DOM Operations	Reflows	Paint Cost	Verdict
Media query dark mode	No extra DOM nodes	Triggers reflow on system theme change	Medium paint cost due to style recalculation	[X] Bad
Class-based dark mode	Adds one class to <body>	Single reflow on class toggle	Lower paint cost, stable layout	[OK] Good

Rendering Pipeline

The browser applies styles based on the presence of the 'dark' class, avoiding media query recalculations and reducing layout shifts.

→Style Calculation

→Layout

→Paint

⚠️ BottleneckStyle Calculation due to media query evaluation in bad pattern

Core Web Vital Affected

LCP

This affects page load speed and rendering performance by controlling when and how dark mode styles are applied.

Optimization Tips

1Use class-based dark mode to control when dark styles apply.

2Avoid media query dark mode to reduce style recalculations on load.

3Toggle the 'dark' class on a high-level element like <body> for best performance.

Performance Quiz - 3 Questions

Which dark mode strategy reduces style recalculations on page load?

A Class-based dark mode using a 'dark' class

B Media query dark mode based on system preferences

C Inline styles toggled by JavaScript

D Using !important in CSS for dark mode styles

DevTools: Performance

How to check: Record a performance profile while toggling dark mode class on <body>. Observe style recalculations and layout shifts.

What to look for: Look for fewer style recalculations and layout shifts in class-based approach compared to media query approach.

Practice

1. What does the dark: prefix in Tailwind CSS do when using class-based dark mode?

easy

A. Applies styles only when a parent element has the dark class.

B. Automatically detects system dark mode and applies styles.

C. Adds a dark background color to all elements.

D. Disables all light mode styles on the page.

Solution

1. Step 1: Understand the dark: prefix role

   The dark: prefix in Tailwind applies styles only when the dark class is present on a parent element.

2. Step 2: Compare with other options

   It does not auto-detect system settings or disable light styles; it depends on the dark class presence.

3. Final Answer:

   Applies styles only when a parent element has the dark class. -> Option A

4. Quick Check:

   dark: prefix = styles with dark class [OK]

Hint: Remember: dark: works only if dark class exists [OK]

Common Mistakes:

• Thinking dark: auto-detects system dark mode
• Assuming it changes styles without the dark class
• Confusing dark: with global dark mode toggle

2. Which of the following is the correct way to enable dark mode using class strategy in Tailwind CSS?

easy

A. "darkMode: 'media'" in tailwind.config.js

B. "darkMode: 'class'" in tailwind.config.js

C. Adding dark attribute to body tag

D. Using dark-mode class instead of dark

Solution

1. Step 1: Check Tailwind config for dark mode strategy

   To use class-based dark mode, you must set darkMode: 'class' in tailwind.config.js.

2. Step 2: Eliminate other options

   darkMode: 'media' uses system preference, not class. The dark class must be added manually; no dark attribute exists. The class name must be exactly dark.

3. Final Answer:

   "darkMode: 'class'" in tailwind.config.js -> Option B

4. Quick Check:

   Config setting for class strategy = 'class' [OK]

Hint: Set darkMode to 'class' in config for class-based dark mode [OK]

Common Mistakes:

• Using 'media' instead of 'class' in config
• Adding wrong attribute instead of class
• Using incorrect class name like 'dark-mode'

3. Given this HTML snippet:

<html class="dark">
  <body>
    <div class="bg-white dark:bg-gray-800 text-black dark:text-white p-4">Hello</div>
  </body>
</html>

What background and text colors will the <div> have when rendered?

medium

A. Background white, text black

B. Background gray-800, text black

C. Background gray-800, text white

D. Background white, text white

Solution

1. Step 1: Identify presence of dark class

   The <html> tag has the dark class, so all dark: styles apply.

2. Step 2: Apply styles based on class

   The div has bg-white and text-black normally, but with dark:bg-gray-800 and dark:text-white when dark class is present. So background is gray-800 and text is white.

3. Final Answer:

   Background gray-800, text white -> Option C

4. Quick Check:

   Dark class present = dark styles apply [OK]

Hint: If dark class exists, dark: styles override [OK]

Common Mistakes:

• Ignoring the dark class on html
• Mixing normal and dark styles incorrectly
• Assuming no style changes without JavaScript

4. You want to toggle dark mode by adding/removing the dark class on body. Which of these JavaScript snippets correctly toggles dark mode?

medium

A. document.body.setAttribute('dark', true)

B. document.body.toggleClass('dark')

C. document.body.className = 'dark'

D. document.body.classList.toggle('dark')

Solution

1. Step 1: Understand class toggling in JavaScript

   The correct method to toggle a class is classList.toggle('className').

2. Step 2: Check each option

   document.body.classList.toggle('dark') uses classList.toggle('dark'), which is correct. document.body.toggleClass('dark') uses a non-existent toggleClass method. document.body.className = 'dark' overwrites all classes, removing others. document.body.setAttribute('dark', true) sets an attribute, not a class.

3. Final Answer:

   document.body.classList.toggle('dark') -> Option D

4. Quick Check:

   Toggle class method = classList.toggle [OK]

Hint: Use classList.toggle('dark') to switch dark mode on/off [OK]

Common Mistakes:

• Using jQuery method toggleClass in plain JS
• Replacing className instead of toggling
• Setting attribute instead of class

5. You want to create a button that toggles dark mode by adding/removing the dark class on the html element. Which React code snippet correctly implements this using Tailwind's class-based dark mode?

hard

A. const toggleDark = () => { document.documentElement.classList.toggle('dark'); };

return Toggle Dark;

B. const toggleDark = () => { document.body.classList.add('dark'); };

return Toggle Dark;

C. const toggleDark = () => { document.documentElement.setAttribute('dark', 'true'); };

return Toggle Dark;

D. const toggleDark = () => { document.body.className = 'dark'; };

return Toggle Dark;

Solution

1. Step 1: Identify correct element and method for toggling

   Tailwind's class-based dark mode expects the dark class on the html element (document.documentElement). Toggling means adding or removing the class, so classList.toggle is best.

2. Step 2: Evaluate each option

   const toggleDark = () => { document.documentElement.classList.toggle('dark'); }; return Toggle Dark; toggles dark on html correctly. const toggleDark = () => { document.body.classList.add('dark'); }; return Toggle Dark; only adds dark to body (no toggle). const toggleDark = () => { document.documentElement.setAttribute('dark', 'true'); }; return Toggle Dark; sets an attribute instead of class. const toggleDark = () => { document.body.className = 'dark'; }; return Toggle Dark; overwrites all classes on body, removing others.

3. Final Answer:

   const toggleDark = () => { document.documentElement.classList.toggle('dark'); }; return <button onClick={toggleDark}>Toggle Dark</button>; -> Option A

4. Quick Check:

   Toggle dark class on html with classList.toggle [OK]

Hint: Toggle dark class on html using classList.toggle [OK]

Common Mistakes:

• Adding class without toggling
• Using wrong element like body
• Setting attribute instead of class
• Overwriting all classes instead of toggling