a11y/iframe-title
Every iframe has a descriptive title. Reglen a11y/iframe-title kører i page-scope med severity 'error' og indgår i tilgængelighed-domænet sammen med 7 andre kontrakter i frameworket.
Hvorfor iframe-title findes
Untitled iframes are announced as just "frame" — the user has no idea what is embedded. The title should describe the embedded content ("Kort over området", "Video: byrundtur").
Sådan håndhæves iframe-title
Reglen iframe-title evalueres på hver enkelt renderet HTML-side for sig, så et fund altid kan føres tilbage til én konkret side og én konkret rettelse i data eller template. Fejler en side, får agenten en finding, hvor fix-instruktionen for iframe-title er formuleret som en konkret arbejdsordre med filnavne og målbare krav — aldrig et vagt råd. Severity 'error' betyder at et brud på iframe-title fejler hele verifikationen med exit-kode 1, så hverken CI eller en agent kan skibe sitet før fundet er rettet.
Domænet: tilgængelighed
A11y-domænet håndhæver WCAG 2.2-krav ud over hvad Lighthouse måler: landmarks, tilgængelige navne, ARIA-integritet, zoom-frihed og skip-links. Tilgængelighed og agent-læsbarhed er næsten samme akse — semantisk HTML tjener både skærmlæsere og sprogmodeller. Netop derfor hører iframe-title hjemme her: kravet kan afgøres maskinelt, og dermed kan det håndhæves i stedet for blot at blive anbefalet.
Test og fixtures
Som alle kontrakter i frameworket har a11y/iframe-title en mutant-test, der beviser at reglen fejler, når kravet brydes — en regel uden en fejlende test er ikke en regel. Golden-fixturet beviser omvendt, at en fuldt compliant side består iframe-title sammen med de øvrige 85 regler, og denne demoside er selv underlagt hele kontrakten.
Relaterede regler
Tilbage til oversigten over alle 86 regler.