Theme tokens and scoped overrides
Variables become especially powerful when a component or page can override a token without rewriting every rule.
✓ What you will learn in this topic
- Explain the key idea: Use inheritance and scoped overrides to build coherent themes and reusable components.
- Apply the concept: A scoped theme changes the card’s colors while the component rules stay the same.
- Avoid this common mistake:
Concept explanation
Because custom properties inherit, a theme class on a wrapper can replace shared values for its descendants. Components can also define local defaults. Keep token names tied to rolesâsuch as surface, text, or accentârather than a particular page location.
A dark theme needs more than swapping a background; check text, borders, hover states, focus rings, and illustrations together. Test each token where it is consumed.
Syntax
A CSS rule has a selector followed by declarations. Each declaration is a property and a value; the braces group the declarations that apply to matching elements.
.demo {
--card-accent: #1d4ed8;
border-inline-start: 0.25rem solid var(--card-accent);
}Example 1: a small page element
Use this HTML as the target and place the CSS in a stylesheet linked to the page, or inside a <style> element while experimenting.
<main class="demo card-grid course-grid dashboard-panel course-card-list dashboard-grid card-layout"><h2>Learning card</h2><p>Clear styles make this information easier to scan.</p><nav class="site-nav"><a href="/learn">Courses</a></nav><label class="form-field"><span>Email</span><input type="email" aria-invalid="true"></label><article class="card course-card dashboard-card theme-dark"><span class="badge status">New</span><div class="course-card__image"></div><h2 class="course-card__title card__title">Course update</h2><p class="status">New lessons are available this week.</p><a href="/learn" aria-current="page">Read the details</a><div class="actions course-card__actions dashboard-panel__actions"><button type="button">View lessons</button><button type="button" disabled>Unavailable</button></div></article></main>.demo {
--card-accent: #1d4ed8;
border-inline-start: 0.25rem solid var(--card-accent);
}Expected result: A scoped theme changes the cardâs colors while the component rules stay the same.
Example 2: a practical interface card
The same idea can style a reusable card on a course page. The class selector keeps the rule attached to this component rather than changing every element of that type.
<section class="demo card-grid course-grid dashboard-panel course-card-list dashboard-grid card-layout"><h2>Learning card</h2><p>Clear styles make this information easier to scan.</p><nav class="site-nav"><a href="/learn">Courses</a></nav><label class="form-field"><span>Email</span><input type="email" aria-invalid="true"></label><article class="card course-card dashboard-card theme-dark"><span class="badge status">New</span><div class="course-card__image"></div><h2 class="course-card__title card__title">Course update</h2><p class="status">New lessons are available this week.</p><a href="/learn" aria-current="page">Read the details</a><div class="actions course-card__actions dashboard-panel__actions"><button type="button">View lessons</button><button type="button" disabled>Unavailable</button></div></article></section>.theme-dark {
--surface: #111c2e;
--ink: #e2e8f0;
}
.card {
color: var(--ink, #172033);
background: var(--surface, #fff);
}Expected result: The course update reads as a distinct interface card, and its content follows the spacing, color, and layout choices in the rule.
Common mistake
Custom properties are case-sensitive and resolve where they are used; a variable defined in an unrelated scope may not be available.
Best practice
Name tokens by purpose, define shared values at a deliberate scope, and use var() fallbacks when they improve resilience.
Practice exercise
Create design tokens for brand color, surface, spacing, and radius, then apply them to a reusable card. Apply it to the example above and inspect the result at a narrow and a wide viewport.
Section summary
- Use inheritance and scoped overrides to build coherent themes and reusable components.
- Name tokens by purpose, define shared values at a deliberate scope, and use var() fallbacks when they improve resilience.
Knowledge check
Why are role-based token names useful?
Reveal the explanation
Role-based names describe meaning, making theme overrides easier to understand.
Finish the module lessons, then take the server-scored module quiz to check your understanding.
Practical example
css.demo {
--card-accent: #1d4ed8;
border-inline-start: 0.25rem solid var(--card-accent);
}
Expected result:
A scoped theme changes the card’s colors while the component rules stay the same.
Hands-on practice task
Create design tokens for brand color, surface, spacing, and radius, then apply them to a reusable card.
In this section
Other lessons in CSS Variables
Broaden your knowledge
Related learning topics
HTML
Learn to structure accessible, meaningful web pages with a complete HTML course from first document to professional application patterns.
JavaScript
Build strong JavaScript foundations with browser examples, focused practice, beginner projects, and module quizzes.