# a11y/accessible-names

Every link and button has an accessible name. Reglen a11y/accessible-names kører i page-scope med severity 'error' og indgår i tilgængelighed-domænet sammen med 7 andre kontrakter i frameworket.

## Hvorfor accessible-names findes

Links and buttons without text, aria-label or a labelled image are announced as just "link"/"button" by screen readers and are opaque to AI agents. Gold standard: every interactive element has a name describing its action or destination.

## Sådan håndhæves accessible-names

Reglen accessible-names 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 accessible-names er formuleret som en konkret arbejdsordre med filnavne og målbare krav — aldrig et vagt råd. Severity 'error' betyder at et brud på accessible-names fejler hele verifikationen med exit-kode 1, så hverken CI eller en agent kan skibe sitet før fundet er rettet.

## Test og fixtures

Som alle kontrakter i frameworket har a11y/accessible-names 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 accessible-names sammen med de øvrige 85 regler, og denne demoside er selv underlagt hele kontrakten.

## Relaterede regler

- [a11y/skip-link](https://pseo.mikkelkrogsholm.dk/regler/a11y/skip-link/)
- [a11y/aria-integrity](https://pseo.mikkelkrogsholm.dk/regler/a11y/aria-integrity/)
- [a11y/duplicate-ids](https://pseo.mikkelkrogsholm.dk/regler/a11y/duplicate-ids/)