55. Stacking contexts and z-index
Module 11 · About 20 minutes · Lesson 54; review earlier concepts as needed
Open Interactive LessonDiscover
What changes when you use stacking contexts and z-index, and how can you prove it?
- Explain stacking contexts and z-index using the example source
- Predict the visual or structural effect of one controlled change
- Repair the supplied fault and verify actual output
Predict
Record the expected structure or visual change before rendering. Name one thing that should remain unchanged.
Understand
z-index participates within stacking contexts rather than ranking every element globally. Positioning, transforms, opacity and other features can establish new contexts. A child with a very large z-index cannot simply escape its ancestor’s stacking context. Compare the ancestor chain, not just the numeric value. Keep overlays rare and test that they do not obscure focus or content.
Important source lines
- index.html:1 <div class="stage"><div class="back">Background card</div><div class="front">Foreground note</div></div>
- A generic flow container when no more specific semantics apply. Attribute guidance: class and global attributes.
- styles.css:1 .stage { position: relative; min-height: 10rem; } .back,.front { position:absolute; padding:2rem; } .back { background:#dae5f6; z-index:1; } .front { background:#ffe4b5; left:3rem; top:2rem; z-index:2; }
- Establishes positioned behavior while retaining normal-flow space. Accepted grammar: static | relative | absolute | sticky | fixed. Context: positioned box.
The first example teaches this lesson’s primary contract. Additional examples are optional related references or applications, each with its own purpose and source; an example without an authored check requires the stated visual/manual review.
Example 1: Stacking contexts and z-index
The foreground note stacks above the other positioned sibling inside the same relevant context.
index.html
<div class="stage"><div class="back">Background card</div><div class="front">Foreground note</div></div>
styles.css
.stage { position: relative; min-height: 10rem; } .back,.front { position:absolute; padding:2rem; } .back { background:#dae5f6; z-index:1; } .front { background:#ffe4b5; left:3rem; top:2rem; z-index:2; }script.js
Expected: The foreground note stacks above the other positioned sibling inside the same relevant context.
Edit and Render This ExampleExample 2: Property: min-height
Provides a minimum height while allowing growth.
index.html
<section class="stage"><article class="sample"><h2>Readable content</h2><p>Longer sample text demonstrates wrapping, spacing and typography. Change a value, inspect its computed style and compare the resulting box.</p><a href="#details">Read the details</a></article><article class="peer">A second item</article></section><section id="details"><h2>Details</h2></section>
styles.css
body { font:18px/1.5 system-ui; color:#17324d; margin:1rem; }
.stage { padding:1rem; border:1px dashed #9caec0; } .sample { padding:1rem; border:2px solid #849ab1; max-width:30rem; }
.sample { min-height: 8rem; }script.js
Expected: Inspect .sample in the block context. Provides a minimum height while allowing growth. The browser’s CSS.supports and computed-style report are the authority for this installed browser; a declaration can be valid but depend on additional layout or font conditions.
Edit and Render This ExampleExample 3: Property: padding
Creates internal space between content and border.
index.html
<section class="stage"><article class="sample"><h2>Readable content</h2><p>Longer sample text demonstrates wrapping, spacing and typography. Change a value, inspect its computed style and compare the resulting box.</p><a href="#details">Read the details</a></article><article class="peer">A second item</article></section><section id="details"><h2>Details</h2></section>
styles.css
body { font:18px/1.5 system-ui; color:#17324d; margin:1rem; }
.stage { padding:1rem; border:1px dashed #9caec0; } .sample { padding:1rem; border:2px solid #849ab1; max-width:30rem; }
.sample { padding: 24px; }script.js
Expected: Inspect .sample in the block context. Creates internal space between content and border. The browser’s CSS.supports and computed-style report are the authority for this installed browser; a declaration can be valid but depend on additional layout or font conditions.
Edit and Render This ExampleExample 4: Property: position
Establishes positioned behavior while retaining normal-flow space.
index.html
<section class="stage"><article class="sample"><h2>Readable content</h2><p>Longer sample text demonstrates wrapping, spacing and typography. Change a value, inspect its computed style and compare the resulting box.</p><a href="#details">Read the details</a></article><article class="peer">A second item</article></section><section id="details"><h2>Details</h2></section>
styles.css
body { font:18px/1.5 system-ui; color:#17324d; margin:1rem; }
.stage { padding:1rem; border:1px dashed #9caec0; } .sample { padding:1rem; border:2px solid #849ab1; max-width:30rem; }.stage { position:relative; min-height:280px; } .sample { position:relative; }
.sample { position: relative; }script.js
Expected: Inspect .sample in the positioned box context. Establishes positioned behavior while retaining normal-flow space. The browser’s CSS.supports and computed-style report are the authority for this installed browser; a declaration can be valid but depend on additional layout or font conditions.
Edit and Render This ExampleExample 5: Property: top
Offsets a positioned element along the top axis.
index.html
<section class="stage"><article class="sample"><h2>Readable content</h2><p>Longer sample text demonstrates wrapping, spacing and typography. Change a value, inspect its computed style and compare the resulting box.</p><a href="#details">Read the details</a></article><article class="peer">A second item</article></section><section id="details"><h2>Details</h2></section>
styles.css
body { font:18px/1.5 system-ui; color:#17324d; margin:1rem; }
.stage { padding:1rem; border:1px dashed #9caec0; } .sample { padding:1rem; border:2px solid #849ab1; max-width:30rem; }.stage { position:relative; min-height:280px; } .sample { position:relative; }
.sample { top: 12px; }script.js
Expected: Inspect .sample in the positioned box context. Offsets a positioned element along the top axis. The browser’s CSS.supports and computed-style report are the authority for this installed browser; a declaration can be valid but depend on additional layout or font conditions.
Edit and Render This ExampleBuild and test
The foreground note stacks above the other positioned sibling inside the same relevant context. Repair the current exercise without removing necessary content. Checks inspect the stated structural/computed/stylesheet contract, not exact source text.
Starter index.html
<div class="stage"><div class="back">Background card</div><div class="front">Foreground note</div></div>
Starter styles.css
.stage { position: relative; min-height: 10rem; } .back,.front { position:absolute; padding:2rem; } .back { background:#dae5f6; z-index:1; } .front { background:#ffe4b5; left:3rem; top:2rem; z-index:0; }Objective contract
[
{
"type": "style",
"selector": ".front",
"property": "z-index",
"value": "2",
"label": ".front computes z-index: 2"
}
]Hint 1
Locate the first difference between the intended result and the real preview. Inspect matching elements and computed styles.
Hint 2
The relevant source uses z-index:2. The exercise instead uses z-index:0. Identify its effect before changing it.
Hint 3
Restore the intended z-index:2 operation or implement an equivalent structure/style. Run the actual checks and explain why it works.
Complete reference solution
index.html
<div class="stage"><div class="back">Background card</div><div class="front">Foreground note</div></div>
styles.css
.stage { position: relative; min-height: 10rem; } .back,.front { position:absolute; padding:2rem; } .back { background:#dae5f6; z-index:1; } .front { background:#ffe4b5; left:3rem; top:2rem; z-index:2; }Explain, reflect and extend
Which part of the actual preview or inspector proves this result? Explain one boundary case and name what automated checks do not verify.
Apply this concept to a different realistic piece of content. Predict its structure or visual behavior, test narrow and wide widths where relevant, then record one invalid case and its repair.
Troubleshooting and professional practice
If nothing changes, confirm that you edited the active file and ran Run Preview, or enabled Auto Preview. Inspect the actual DOM because the browser may repair invalid nesting. For CSS, check selector matches, valid declarations, active queries and computed values. Preserve local asset paths and inspect warnings. The foreground note stacks above the other positioned sibling inside the same relevant context.
Knowledge check
Explain why the stated result follows from the source. Predict a second input or width and test it independently. Automated contracts and written explanations are reviewed separately.
Optional AI prompts
- Explain this lesson’s source line by line using the actual objective above.
- Help implement one small extension and define normal, boundary and failure tests.
- Review/debug the source against actual preview observations; verify standards and never claim rendering without evidence.