DiscoveryVIP / HTML & CSS AcademyHelp

85. Reviewing accessibility and usability

Module 17 · About 20 minutes · Lesson 84; review earlier concepts as needed

Open Interactive Lesson

Discover

What changes when you use reviewing accessibility and usability, and how can you prove it?

Predict

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

Understand

Review both objective checks and human experience. Missing alt attributes, absent labels and empty links are detectable patterns; whether an alternative description is appropriate requires judgment. Check heading meaning, keyboard flow, zoom, contrast and error recovery with realistic tasks. The audit lists findings and explicit manual-review items, not a certification badge.

Important source lines

index.html:1 <main><h1>Public workshop information</h1><img src="assets/landscape.svg" alt="" width="640" height="400"><h2>How to attend</h2><p><a href="#register">Registration details</a></p><section id="register"><h3>Registration</h3><p>Contact the organizer.</p></section></main>
The document’s principal content, normally one visible instance. Attribute guidance: id useful for skip links.
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: Reviewing accessibility and usability

The link has meaningful text, the image is explicitly decorative and the document has a coherent heading sequence.

index.html

<main><h1>Public workshop information</h1><img src="assets/landscape.svg" alt="" width="640" height="400"><h2>How to attend</h2><p><a href="#register">Registration details</a></p><section id="register"><h3>Registration</h3><p>Contact the organizer.</p></section></main>

styles.css

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

script.js

Expected: The link has meaningful text, the image is explicitly decorative and the document has a coherent heading sequence.

Edit and Render This Example
Example 2: Property: height

Sets preferred box height; fixed heights can clip growing content.

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 { height: 140px; }

script.js

Expected: Inspect .sample in the block context. Sets preferred box height; fixed heights can clip growing content. 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 Example
Example 3: Property: max-width

Constrains the maximum width without requiring a fixed width.

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 { max-width: 28rem; }

script.js

Expected: Inspect .sample in the block context. Constrains the maximum width without requiring a fixed width. 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 Example
Example 4: Keyboard tabs

Roving tabindex keeps one tab in sequential focus. Arrow keys move within the tab list.

index.html

<section data-component aria-label="Keyboard tabs">
<div role="tablist" aria-label="Account details"><button id="a" role="tab" aria-selected="true" aria-controls="pa">Profile</button><button id="b" role="tab" aria-selected="false" aria-controls="pb" tabindex="-1">Billing</button></div><div id="pa" role="tabpanel" aria-labelledby="a">Profile details</div><div id="pb" role="tabpanel" aria-labelledby="b" hidden>Billing details</div>
</section>

styles.css

* { box-sizing: border-box; }
body { margin: 0; color: #142537; background: #eef4fa; font: 16px/1.5 system-ui, sans-serif; }
[data-component] { max-width: 44rem; margin: 1rem auto; padding: 1rem; border: 1px solid #a1b2c4; border-radius: .75rem; background: white; }
button, input, select, textarea { font: inherit; padding: .4rem .65rem; margin: .2rem; }
button { cursor: pointer; } :focus-visible { outline: 3px solid #a33e0c; outline-offset: 3px; }
label { display: block; } [hidden] { display: none !important; }
table { border-collapse: collapse; } th, td { padding: .4rem; border-bottom: 1px solid #a1b2c4; }

script.js

const root=document.querySelector("[data-component]");
const tabs=[...root.querySelectorAll('[role=tab]')];function select(index){tabs.forEach((tab,i)=>{tab.tabIndex=i===index?0:-1;tab.setAttribute('aria-selected',String(i===index));root.querySelector('#'+tab.getAttribute('aria-controls')).hidden=i!==index;});tabs[index].focus();}tabs.forEach((tab,i)=>{tab.onclick=()=>select(i);tab.onkeydown=e=>{const next={ArrowRight:(i+1)%tabs.length,ArrowLeft:(i+tabs.length-1)%tabs.length,Home:0,End:tabs.length-1}[e.key];if(next!==undefined){e.preventDefault();select(next);}};});

Expected: Add a third tab and test wrapping.

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

Build and test

The link has meaningful text, the image is explicitly decorative and the document has a coherent heading sequence. Repair the current exercise without removing necessary content. Checks inspect the stated structural/computed/stylesheet contract, not exact source text.

Starter index.html

<main><h1>Public workshop information</h1><img src="assets/landscape.svg" alt="" width="640" height="400"><h2>How to attend</h2><p><a href="#register"></a></p><section id="register"><h3>Registration</h3><p>Contact the organizer.</p></section></main>

Starter styles.css

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

Objective contract

[
  {
    "type": "text",
    "selector": "a",
    "value": "Registration details",
    "label": "Link has meaningful registration text"
  }
]
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 Registration details</a>. The exercise instead uses </a>. Identify its effect before changing it.

Hint 3

Restore the intended Registration details</a> operation or implement an equivalent structure/style. Run the actual checks and explain why it works.

Complete reference solution

index.html

<main><h1>Public workshop information</h1><img src="assets/landscape.svg" alt="" width="640" height="400"><h2>How to attend</h2><p><a href="#register">Registration details</a></p><section id="register"><h3>Registration</h3><p>Contact the organizer.</p></section></main>

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 link has meaningful text, the image is explicitly decorative and the document has a coherent heading sequence.

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 86: Responsive navigation components

Detailed learning and editor help · Standards reference