14. Images and alternative text
Module 3 · About 20 minutes · Lesson 13; review earlier concepts as needed
Open Interactive LessonDiscover
What changes when you use images and alternative text, and how can you prove it?
- Explain images and alternative text 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
An img is a void element with no closing tag. src identifies the resource, while alt supplies a text alternative for its purpose. Decorative images generally use an empty alt rather than repeating irrelevant details. Width and height establish an aspect ratio and reduce layout shifts. The academy includes original local SVG illustrations; uploaded assets are restricted to supported raster image formats.
Important source lines
- index.html:1 <h1>Coastal journal</h1>
- The highest-level heading for a page topic. Attribute guidance: global attributes.
- index.html:2 <img src="assets/landscape.svg" width="640" height="400" alt="Layered blue hills beneath a pale morning sky">
- A replaced image with a purpose-appropriate text alternative. Attribute guidance: src, alt; width/height; loading/decoding when appropriate.
- styles.css:1 img { max-width: 100%; height: auto; }
- Constrains the maximum width without requiring a fixed width. Accepted grammar: none | <length-percentage [0,∞]> | min-content | max-content | fit-content | fit-content(<length-percentage [0,∞]>) | <calc-size()> | <anchor-size()>. Context: block.
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: Images and alternative text
The illustration has a purpose-specific text alternative and scales within its available width.
index.html
<h1>Coastal journal</h1> <img src="assets/landscape.svg" width="640" height="400" alt="Layered blue hills beneath a pale morning sky">
styles.css
img { max-width: 100%; height: auto; }script.js
Expected: The illustration has a purpose-specific text alternative and scales within its available width.
Edit and Render This ExampleExample 2: Element: img
A replaced image with a purpose-appropriate text alternative.
index.html
<img src="assets/shapes.svg" alt="Overlapping warm circle and blue square" width="640" height="400">
styles.css
body { font:18px/1.6 system-ui; margin:1.5rem; color:#17324d; } img,video,svg { max-width:100%; height:auto; } th,td { padding:.5rem; border:1px solid #a8b8c8; } :focus-visible { outline:3px solid #a44322; outline-offset:3px; }script.js
Expected: A replaced image with a purpose-appropriate text alternative. Review its real DOM and native behavior; structural/media-only examples are labeled.
Edit and Render This ExampleExample 3: Element: h1
The highest-level heading for a page topic.
index.html
<h1>Workshop handbook</h1><p>A principal heading introduces the page.</p>
styles.css
body { font:18px/1.6 system-ui; margin:1.5rem; color:#17324d; } img,video,svg { max-width:100%; height:auto; } th,td { padding:.5rem; border:1px solid #a8b8c8; } :focus-visible { outline:3px solid #a44322; outline-offset:3px; }script.js
Expected: The highest-level heading for a page topic. Review its real DOM and native behavior; structural/media-only examples are labeled.
Edit and Render This ExampleExample 4: Element: p
A paragraph of prose.
index.html
<p>One idea belongs in a coherent paragraph.</p><p>A second paragraph develops another idea.</p>
styles.css
body { font:18px/1.6 system-ui; margin:1.5rem; color:#17324d; } img,video,svg { max-width:100%; height:auto; } th,td { padding:.5rem; border:1px solid #a8b8c8; } :focus-visible { outline:3px solid #a44322; outline-offset:3px; }script.js
Expected: A paragraph of prose. Review its real DOM and native behavior; structural/media-only examples are labeled.
Edit and Render This ExampleExample 5: Element: strong
Strong importance rather than merely bold appearance.
index.html
<p><strong>Important:</strong> keep a recovery copy before replacing files.</p>
styles.css
body { font:18px/1.6 system-ui; margin:1.5rem; color:#17324d; } img,video,svg { max-width:100%; height:auto; } th,td { padding:.5rem; border:1px solid #a8b8c8; } :focus-visible { outline:3px solid #a44322; outline-offset:3px; }script.js
Expected: Strong importance rather than merely bold appearance. Review its real DOM and native behavior; structural/media-only examples are labeled.
Edit and Render This ExampleBuild and test
The illustration has a purpose-specific text alternative and scales within its available width. Repair the current exercise without removing necessary content. Checks inspect the stated structural/computed/stylesheet contract, not exact source text.
Starter index.html
<h1>Coastal journal</h1> <img src="assets/landscape.svg" width="640" height="400" alt="">
Starter styles.css
img { max-width: 100%; height: auto; }Objective contract
[
{
"type": "attr",
"selector": "img",
"property": "alt",
"value": "Layered blue hills beneath a pale morning sky",
"label": "img has alt=Layered blue hills beneath a pale morning sky"
}
]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 alt="Layered blue hills beneath a pale morning sky". The exercise instead uses alt="". Identify its effect before changing it.
Hint 3
Restore the intended alt="Layered blue hills beneath a pale morning sky" operation or implement an equivalent structure/style. Run the actual checks and explain why it works.
Complete reference solution
index.html
<h1>Coastal journal</h1> <img src="assets/landscape.svg" width="640" height="400" alt="Layered blue hills beneath a pale morning sky">
styles.css
img { max-width: 100%; height: auto; }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 illustration has a purpose-specific text alternative and scales within its available width.
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.
Continue to Lesson 15: Figures, captions and responsive images