DiscoveryVIP / HTML & CSS AcademyHelp

15. Figures, captions and responsive images

Module 3 · About 20 minutes · Lesson 14; review earlier concepts as needed

Open Interactive Lesson

Discover

What changes when you use figures, captions and responsive images, and how can you prove it?

Predict

Record the expected structure or visual change before rendering. Name one thing that should remain unchanged.

Understand

A figure groups self-contained content with an optional figcaption. The caption adds context; alt still describes an image’s relevant information. max-width prevents overflow while height:auto preserves the intrinsic ratio. Responsive source selection with picture or srcset changes the resource chosen by the browser, whereas CSS changes display size. Test both rather than assuming one solves the other.

Important source lines

index.html:1 <figure><img src="assets/landscape.svg" width="640" height="400" alt="Blue hill shapes"><figcaption>Original study illustration: layered landscape.</figcaption></figure>
Self-contained content optionally associated with a caption. Attribute guidance: global attributes.
styles.css:1 figure { margin: 0; } img { max-width: 100%; height: auto; }
Creates external separation; some block margins can collapse. Accepted grammar: <'margin-top'>{1,4}. 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: Figures, captions and responsive images

The caption belongs to the figure and the image keeps its aspect ratio as the viewport narrows.

index.html

<figure><img src="assets/landscape.svg" width="640" height="400" alt="Blue hill shapes"><figcaption>Original study illustration: layered landscape.</figcaption></figure>

styles.css

figure { margin: 0; } img { max-width: 100%; height: auto; }

script.js

Expected: The caption belongs to the figure and the image keeps its aspect ratio as the viewport narrows.

Edit and Render This Example
Example 2: Element: figure

Self-contained content optionally associated with a caption.

index.html

<figure><img src="assets/landscape.svg" alt="Blue hills" width="640" height="400"><figcaption>Landscape study.</figcaption></figure>

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: Self-contained content optionally associated with a caption. Review its real DOM and native behavior; structural/media-only examples are labeled.

Edit and Render This Example
Example 3: 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 Example
Example 4: Element: figcaption

The caption for a figure.

index.html

<figure><pre>HTML → CSS → Preview</pre><figcaption>A learning workflow.</figcaption></figure>

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 caption for a figure. Review its real DOM and native behavior; structural/media-only examples are labeled.

Edit and Render This Example
Example 5: 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 Example

Build and test

The caption belongs to the figure and the image keeps its aspect ratio as the viewport narrows. Repair the current exercise without removing necessary content. Checks inspect the stated structural/computed/stylesheet contract, not exact source text.

Starter index.html

<figure><img src="assets/landscape.svg" width="640" height="400" alt="Blue hill shapes"></figure>

Starter styles.css

figure { margin: 0; } img { max-width: 100%; height: auto; }

Objective contract

[
  {
    "type": "count",
    "selector": "figure figcaption",
    "value": 1,
    "label": "Include 1 matching figure figcaption element(s)"
  }
]
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 <figcaption>Original study illustration: layered landscape.</figcaption>. The exercise instead uses an omitted operation. Identify its effect before changing it.

Hint 3

Restore the intended <figcaption>Original study illustration: layered landscape.</figcaption> operation or implement an equivalent structure/style. Run the actual checks and explain why it works.

Complete reference solution

index.html

<figure><img src="assets/landscape.svg" width="640" height="400" alt="Blue hill shapes"><figcaption>Original study illustration: layered landscape.</figcaption></figure>

styles.css

figure { margin: 0; } 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 caption belongs to the figure and the image keeps its aspect ratio as the viewport narrows.

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

  1. Explain this lesson’s source line by line using the actual objective above.
  2. Help implement one small extension and define normal, boundary and failure tests.
  3. Review/debug the source against actual preview observations; verify standards and never claim rendering without evidence.

Continue to Lesson 16: Ordered and unordered lists

Detailed learning and editor help · Standards reference