TRAQDOKUMENTATION

Evidensstandard og kodediffs

En påstand om en teknisk fejl har kun gyldighed, hvis den kan reproduceres af en anden fagperson uden adgang til hemmelige forudsætninger. Her beskrives TRAQs formelle evidensstandard.

Enhver observation i en rapport fra TRAQ er forankret i et entydigt evidens-ID og ledsaget af råartefakter, præcise reproduktionstrin og en færdig kodediff, som jeres udvikler kan committe direkte.

Hvert fund har et evidens-ID

Hver identificeret fejl i en TRAQ Blueprint rapport registreres med:

  • Unikt fund-ID: fx F-014 med reference til det tilknyttede succeskriterium.
  • Reproduktionstrin: Nummereret rækkefølge af handlinger, udført fra en nulstillet browsersession.
  • Forventet resultat: Hvordan komponenten burde opføre sig efter WCAG-standarden.
  • Observeret resultat: Hvad hjælpeteknologien eller tastaturfokuset rent faktisk registrerede.
  • Brugerkonsekvens: Den konkrete barriere, en person med en funktionsnedsættelse oplever.
  • Kodediff og rettelsesanvisning: Konkret forslag til opmærkningsændring for udvikleren.

Fejlene prioriteres efter fire faste alvorsgrader, som beskrevet under Alvorsgrader og prioritering.

Godkendte evidenstyper

TRAQ accepterer ikke udokumenterede skøn som grundlag for alvorlige fejl. Hvert fund understøttes af mindst ét af følgende standardiserede artefakter:

Evidenstype Beskrivelse Typisk anvendelse
keyboard_steps Nummereret sekvens af tastetryk (Tab, Shift+Tab, Enter, Mellemrum) med notering af observeret fokussti Manglende fokusindikatorer, spring i fokusrækkefølge
sr_transcript Ordret udskrift fra NVDA Speech Viewer (skærmlæserens faktiske taleoutput) Forkert tilgængeligt navn, manglende rolle, utilstrækkelige labels
dom_capture Rå HTML-uddrag af komponenten, gemt direkte fra den renderede DOM Parsing-fejl, manglende attributter, ugyldig semantik
video Skærmoptagelse med synlig tastatur- og museindikator Tastaturfælder, dynamiske modaler og tidsafhængige indlæsningstrin
structured_data_extract Rå JSON-LD ekstrakt med tidsstempel og URL Manglende eller fejlagtige metadata for e-handel

Et stillbillede (screenshot) er sjældent tilstrækkeligt alene: En tastaturfælde eller en ulogisk fokusrækkefølge kan i sagens natur ikke bevises med et statisk billede. Ved fejl, der blokerer en transaktion, kræver vores standard altid enten en tastatursekvens eller et skærmlæser-transskript.

Anonymisering og databeskyttelse

Når evidens indsamles, håndhæves en fast procedure:

  1. Der anvendes udelukkende fiktive testdata ved formularindtastninger.
  2. Skulle medarbejdernavne eller lignende optræde i skærmoptagelser, maskeres disse fuldstændigt.
  3. Rigtige betalingskortnumre indtastes eller registreres aldrig.

Et konkret eksempel fra praksis

For at illustrere evidensstandarden vises her et anonymiseret uddrag af et typisk fund fra en e-handelsaudit:

Fund F-014: Farvevælger på produktdetalje kan ikke betjenes med tastatur

  • Berørte kriterier: 2.1.1 Tastatur (Niveau A), 4.1.2 Navn, rolle, værdi (Niveau A).
  • Enhed: Produktdetalje (/produkter/vare-eksempel).
  • Alvorsgrad: Grad 1 (blokerer transaktionen for tastaturbrugere).
  • Evidenstype: keyboard_steps + dom_capture.

Reproduktionstrin

  1. Åbn URL i en ren browserprofil uden museinput.
  2. Naviger med Tab forbi produktbilleder ned til variantsektionen.
  3. Observer at fokus springer direkte fra produktets overskrift til mængdevælgeren, uden at ramme de fem farvecirkler.
  4. Forsøg på at aktivere farver med piletasterne giver ingen reaktion.

Observeret DOM-opmærkning (før rettelse)

<!-- Mangler interaktivt element, rolle og tastaturfokus -->
<div class="color-swatch-list">
  <div class="swatch selected" data-color="sort" style="background-color: #000;"></div>
  <div class="swatch" data-color="hvid" style="background-color: #fff;"></div>
</div>

Brugerkonsekvens

En bruger, der navigerer med tastatur eller skærmlæser, kan ikke vælge en anden farve end standardsort. Varen kan derfor ikke bestilles i den ønskede variant.

Anbefalet rettelsesspecifikation (kodediff)

--- a/components/ColorSwatch.html
+++ b/components/ColorSwatch.html
@@ -1,4 +1,5 @@
-<div class="color-swatch-list">
-  <div class="swatch selected" data-color="sort" style="background-color: #000;"></div>
-  <div class="swatch" data-color="hvid" style="background-color: #fff;"></div>
-</div>
+<fieldset class="color-swatch-list">
+  <legend class="sr-only">Vælg farve</legend>
+  <button type="button" role="radio" aria-checked="true" aria-label="Sort farve" class="swatch selected"></button>
+  <button type="button" role="radio" aria-checked="false" aria-label="Hvid farve" class="swatch"></button>
+</fieldset>

Dette demonstrerer princippet: en klar fejlidentifikation, uomtvistelig evidens, en forklaret menneskelig konsekvens og en færdig kodeløsning til jeres udvikler.