Ondersteuning voor Aangepaste Methodologie

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Not for use with personal data

Configuratie van Aangepaste Handmatige Testmethodologie in axe Auditor

Doel

Klanten die axe Auditor gebruiken, moeten soms de handmatige testmethodologie aanpassen (de DequeWay). Deze behoefte kan voortkomen uit:

  • Specifieke interne beleidsrichtlijnen die extra of minder controles vereisen.
  • Interne richtlijnen om specifieke tools te gebruiken bij het uitvoeren van tests.
  • Beleidsbeslissingen die verschillende probleemkenmerken wijzigen (impact, beschrijvingen, aanbevelingen).

Dit document beschrijft de aanpassingen die kunnen worden gedaan aan de handmatige testmethodologie in axe Auditor, en legt uit hoe deze wijzigingen terugvloeien naar Deque voor verpakking en implementatie in uw gehoste exemplaar.

Hoe dit werkt: rollen en workflow

Het axe Auditor-exemplaar van uw organisatie wordt gehost en beheerd door Deque. Dat betekent dat Deque verantwoordelijk is voor de installatie, versievolgorde, verpakking en implementatie van de methodologie. Uw team is alleen verantwoordelijk voor het bewerken van de methodologieconfiguratiebestanden. U hoeft geen versienummers bij te werken, pakketten te bouwen of installatie- of databasecommando’s uit te voeren. Deque regelt dit allemaal voor u.

Het end-to-end proces is:

Stap Eigenaar Actie
1 Deque Bezorgen uw team de huidige methodologie (DequeWay) bundel.
2 Klant Pakt de bundel uit naar een werkplek, waardoor een map genaamd package ontstaat.
3 Klant Maakt een back-up van de originele package map voordat er wijzigingen worden aangebracht.
4 Klant Maakt de afgesproken wijzigingen in de methodologie volgens de onderstaande secties.
5 Klant Valideert de bewerkte JSON-bestanden (zie Voordat u begint).
6 Klant Stuurt de volledige package map terug naar Deque, in dezelfde structuur als waarin deze werd geleverd.
7 Deque Versiet, verpakt en map de methodologie naar de juiste axe-core versie, en implementeert het naar een testexemplaar voor verificatie.
8 Klant Verifieert de wijzigingen op het testexemplaar en bevestigt goedkeuring.
9 Deque Promoveert de geverifieerde methodologie naar uw productie exemplaar.

Scoopnotitie: Dit document geeft alle beschikbare aanpassingstypen weer voor volledigheid. De specifieke wijzigingen die uw team zal doorvoeren, moeten in lijn zijn met de afgesproken reikwijdte van de wijzigingen.

Voordat u begint

1. Maak een back-up van het origineel. Voordat u iets gaat bewerken, maakt u een kopie van de uitgepakte package map. Als een bewerking de bundel beschadigt, is dit uw enige schone manier om terug te keren.

cp -r package package_backup_original

2. Bewerk alleen de bestanden die in elke sectie worden vermeld. De bestanden zijn van elkaar afhankelijk. Het bewerken van een bestand dat niet vermeld staat voor een bepaalde wijziging — of het missen van een bestand dat is vermeld staat — kan een bundel opleveren die pas faalt nadat deze terugkeert naar Deque.

3. Controleer elk bestand dat u aanraakt. Elk bestand is JSON en moet na bewerking geldig JSON blijven (geen komma's na de laatste eigenschappen, gebalanceerde accolades/schuingestreepte haken). Valideer voordat u het verstuurt:

# Validate a single file
python3 -m json.tool package/dist/bundle/descriptions.json > /dev/null && echo "VALID" || echo "INVALID"

# Or validate every JSON file in the bundle at once
find package/dist -name "*.json" -print0 | while IFS= read -r -d '' f; do
  python3 -m json.tool "$f" > /dev/null 2>&1 && echo "VALID:   $f" || echo "INVALID: $f"
done

4. Taalveronderstelling. Deze instructies gaan uit van Engels (en). Als uw organisatie methodologie in aanvullende talen vereist, laat dit aan Deque weten — Deque maakt taalondersteuning mogelijk tijdens de configuratie. In dat geval moet elke wijziging die u maakt in een .en.json bestand ook worden doorgevoerd in het overeenkomstige lokale bestand (bijv., de .nl.json equivalent) voor elke aanvullende taal.

Toegestane updates

Werk de testmethodologie bij voor een specifiek controlepunt

Handig wanneer u de testinstructies voor een specifiek controlepunt in axe Auditor wilt wijzigen.

Bestanden bijgewerkt: package/dist/bundle/locales/checkpoints.en.json

Stappen:

  1. Vind het specifieke Deque-controlepunt in het JSON-bestand (bijv., 1.1.1.a).
  2. Zoek naar het testing-methodology attribuut onder dat specifieke controlepunt.
  3. Maak geschikte updates aan elk type asset dat onder testing-methodology wordt vermeld.
  4. Sla het bestand op zijn huidige locatie op.

Opmerking: De naam van het controlepunt zichtbaar in axe Auditor kan ook worden gewijzigd met dezelfde instructies. In plaats van de testing-methodology sectie bij te werken, werkt u het name attribuut onder het relevante controlepunt in hetzelfde bestand bij.

Update de impact van een regel

U kunt het impactniveau (blokker, kritiek, ernstig, gematigd, gering) wijzigen voor elk probleem binnen axe Auditor. Als u echter de standaard impact voor een regel moet wijzigen, volg dan deze instructies.

Impacten in axe Auditor worden opgeslagen op het regel niveau, niet op het niveau van een WCAG-succescriterium of controlepunt. Een enkele regel kan meerdere Deque-controlepunten beïnvloeden (bijv. regel-ID alt-text-dynamic-image-inconsistent). Het wijzigen van de impact voor de regel verandert de standaardimpact voor een probleem dat wordt veroorzaakt door de schending van deze regel over alle WCAG-succescriteria die aan de regel zijn gekoppeld.

Bestanden bijgewerkt: package/dist/bundle/descriptions.json

Stappen:

  1. Vind de specifieke Deque-regel in het JSON-bestand (bijv., alt-text-dynamic-image-inconsistent).
  2. Zoek naar het impact attribuut onder die specifieke regel.
  3. Werk de impact bij met een numerieke waarde (zie de tabel hieronder).
  4. Sla het bestand op zijn huidige locatie op.

Impactwaarde toewijzingen

Impactwaarde Impact in axe Auditor
5 Blokker
4 Kritiek
3 Ernstig
2 Gematigd
1 Gering

Voeg een nieuwe toegankelijkheidsstandaard toe (bijv. een organisatiespecifieke standaard)

Als u organisatiespecifieke teststandaarden heeft die u naast de bestaande standaarden (zoals WCAG 2.1 AA of ACAA) aan uw teams ter beschikking wilt stellen, gebruik dan de volgende stappen.

⚠️ Deque intern — oplossen vóór publicatie: De bestandslijst voor deze sectie verwijst naar drie controlepunt-gerelateerde paden die niet consistent zijn met de rest van het document (dat gebruik maakt van dist/bundle/…): package/dist/checkpoints.json, package/dist/issue-descriptions.json, en package/dist/bundle/checkpoints.json. Bevestig of dist/checkpoints.json en dist/issue-descriptions.json werkelijk verschillende samengestelde bestanden zijn, of dat dit padfouten zijn, en werk de lijst vervolgens bij en verwijder deze opmerking.

weergave teststandaard

Bestanden bijgewerkt:

  • package/dist/bundle/standards.json
  • package/dist/bundle/descriptions.json
  • package/dist/bundle/testingMethodologies.json
  • package/dist/bundle/locales/standards.en.json
  • package/dist/checkpoints.json
  • package/dist/issue-descriptions.json
  • package/dist/bundle/checkpoints.json

Stappen:

  1. Maak een nieuw array-object voor de standaard in standards.json. De gemakkelijkste manier is om het hele object voor wcag21aa te kopiëren en het aan de onderkant van het bestand toe te voegen.
  2. Verander de id van het nieuw gekopieerde object naar iets unieks dat de standaard die het vertegenwoordigt aangeeft.
  3. Werk de rubric array voor het nieuwe object bij om alle onderliggende teststandaarden weer te geven die deel uitmaken van deze nieuwe standaard.
  4. In descriptions.json, voeg voor alle regels die met uw nieuwe standaard te maken hebben, de id van de nieuwe standaard (van standards.json) toe aan de standards array.
  5. In testingMethodologies.json, voeg de id van de nieuwe standaard toe onder de standards array voor elk type digitaal bezit waarop deze standaard van toepassing is.
  6. In standards.en.json, voeg een nieuw object toe met de id en naam van de nieuwe standaard. Het name veld is wat gebruikers in de axe Auditor gebruikersinterface zien.
  7. In dist/checkpoints.json, werk de standards array bij onder elke probleemomschrijving voor de toepasselijke controlepunten.
  8. In issue-descriptions.json, werk de standards array bij voor alle toepasselijke regelobjecten.
  9. In dist/bundle/checkpoints.json, werk de standards array van elk toepasselijk controlepunt bij met de juiste standaard.

Werk de korte en lange probleemomschrijvingen bij voor specifieke regels

Gebruik deze instructies om de selectie tekst voor probleemomschrijvingen (kort) en de lange beschrijving van het probleemtype voor elke regel bij te werken. Een enkele regel kan van invloed zijn op meerdere WCAG Succescriteria — het wijzigen van deze tekst beïnvloedt alle Succescriteria waarmee het is verbonden.

Lange en korte beschrijving

Bestanden bijgewerkt: package/dist/bundle/locales/descriptions.en.json

Stappen:

  1. In descriptions.en.json, zoek naar de specifieke regel (bijv. alt-text-dynamic-image-inconsistent).
  2. Werk de tekst bij voor shortText (Korte Probleemomschrijving) en issueDescText (Lange Probleemomschrijving) waar nodig.
  3. Sla het bestand op in de huidige locatie.

Werk de aanbeveling voor herstel bij

Als u de herstelbibliotheek en bijbehorende beschrijvingen wilt wijzigen om aan te sluiten bij uw beleid, gebruik dan de volgende instructies.

herstel Aanbevelingen

Bestanden bijgewerkt: package/dist/bundle/locales/recommendations.en.json

Stappen:

  1. In recommendations.en.json, zoek naar de specifieke regel (bijv. alt-text-dynamic-image-inconsistent) en controlepuntcombinatie waarvoor u de herstelbibliotheek wilt wijzigen.
  2. Werk de tekst bij voor recommendationType (Aanbevelingstechniek), rule, howtofix, en background (secties van de aanbeveling om te herstellen) waar nodig.
  3. Sla het bestand op in de huidige locatie.

Verwijder typen digitale activa

Gebruik dit wanneer een bepaald type activa niet van toepassing is op uw organisatie (bijvoorbeeld als PDF- of Android-tests buiten de scope vallen).

Bestanden om bij te werken:

  • dist/bundle/testingMethodologies.json — belangrijkste testmethodologieën gegevens
  • dist/bundle/locales/testingMethodologies.en.json — Engelse vertalingen

Stap 1: Verwijder uit het testmethodologieën bestand

Bestand: dist/bundle/testingMethodologies.json

Vind en verwijder het hele object voor de methode die u wilt verwijderen.

// BEFORE — remove this entire object (example: "native-mobile-android"):
{
  "id": "native-mobile-android",
  "techniques": ["general"],
  "standards": [
    "wcag2a", "wcag21a", "wcag22a",
    "wcag2aa", "wcag21aa", "wcag22aa",
    "acaa", "en301549-wad",
    "508-2017-wcag2", "508-2017-wcag21"
  ]
}
// AFTER — object completely removed

Stap 2: Verwijder uit het Engelse localebestand

Bestand: dist/bundle/locales/testingMethodologies.en.json

Verwijder hetzelfde methodeobject uit dit bestand.

Voeg een nieuw type digitaal activum toe

Gebruik dit om een nieuw type digitaal activum toe te voegen — bijvoorbeeld een web-app of macos methode. Het onderstaande voorbeeld gebruikt web-app; vervang uw eigen activumtype-id indien nodig.

Bestanden om bij te werken:

  • dist/bundle/testingMethodologies.json — belangrijkste testmethodologieën gegevens
  • dist/bundle/locales/testingMethodologies.en.json — Engelse vertalingen
  • dist/bundle/locales/checkpoints.en.json — Engelse controlepuntinhoud met testmethodologiesecties
  • dist/bundle/checkpoints.json — belangrijkste controlepunten gegevens
  • dist/bundle/descriptions.json — probleemomschrijvingen met testmethodologiereferenties
  • dist/bundle/schemata.json — schema-definities met testmethodologiereferenties

Stap 1: Voeg toe aan het testmethodologieën bestand

Bestand: dist/bundle/testingMethodologies.json

Voeg het nieuwe methodeobject toe aan de array.

{
  "id": "web-app",
  "techniques": ["general", "html", "aria", "css"],
  "standards": [
    "wcag2a", "wcag21a", "wcag22a",
    "wcag2aa", "wcag21aa", "wcag22aa",
    "acaa", "en301549-wad",
    "508-2017-wcag2", "508-2017-wcag21"
  ]
}

Stap 2: Voeg toe aan het Engelse localebestand

Bestand: dist/bundle/locales/testingMethodologies.en.json

Voeg hetzelfde methodologieobject toe aan dit bestand.

Stap 3: Voeg referenties toe aan het checkpoint-bestand

Bestand: dist/bundle/checkpoints.json

Voor elk checkpoint dat de nieuwe methodologie moet ondersteunen, voeg het toe aan de testingMethodologies array van dat checkpoint.

{
  "id": "1.4.3.a",
  "testingMethodologies": [
    "desktop", "mobile", "kiosk",
    "native-mobile-ios", "native-mobile-android",
    "pdf",
    "web-app",          // ← Add this line
    "ms-excel", "ms-powerpoint", "ms-word", "windows-desktop"
  ]
}

Stap 4: Voeg inhoud over testmethodologie toe aan het checkpoint-locale bestand

Bestand: dist/bundle/locales/checkpoints.en.json

Voor elk checkpoint dat de nieuwe methodologie moet ondersteunen, voeg de inhoud van de testmethodologie toe.

{
  "1.4.3.a": {
    "name": "Color Contrast (Minimum)",
    "testing-methodology": {
      "desktop": "<ol>...</ol>",
      "mobile": "<ol>...</ol>",
      "native-mobile-android": "<ol>...</ol>",
      "web-app": "<ol>\n<li>Open the web application in a modern browser</li>\n<li>Use browser developer tools to inspect text elements</li>\n<li>Check color contrast ratios using accessibility tools</li>\n<li>Verify contrast meets WCAG requirements</li>\n</ol>",  // ← Add this new entry
      "pdf": "<ol>...</ol>"
    }
  }
}

Stap 5: Voeg referenties toe aan het beschrijvingen-bestand

Bestand: dist/bundle/descriptions.json

Voor probleemomschrijvingen die de nieuwe methodologie moeten ondersteunen, voeg het toe aan hun testingMethodologies array.

{
  "id": "some-issue-id",
  "data": [
    {
      "type": "issue",
      "testingMethodologies": [
        "desktop", "mobile",
        "native-mobile-android", "pdf",
        "web-app"        // ← Add this line
      ]
    }
  ]
}

Stap 6: Voeg referenties toe aan het schema-bestand

Bestand: dist/bundle/schemata.json

Voeg de nieuwe testmethodologie toe aan de schema-definities.

{
  "testingMethodologies": {
    "desktop": null,
    "kiosk": null,
    "mobile": null,
    "native-mobile-ios": null,
    "native-mobile-android": null,
    "pdf": null,
    "web-app": null,   // ← Add this line
    "ms-excel": null,
    "ms-powerpoint": null,
    "ms-word": null,
    "windows-desktop": null
  }
}

Voeg een nieuw checkpoint toe

Een niet-WCAG checkpoint toevoegen

Belangrijk: Niet-WCAG checkpoints ondersteunen niet vooraf gedefinieerde beschrijvingen of aanbevelingen via descriptions.json en recommendations.json niet. Bij het loggen van problemen met deze checkpoints voer je handmatig beschrijvingen en aanbevelingen in met behulp van de Maak je eigen beschrijving functie in de tool.

Bestanden om bij te werken — slechts 2:

  • package/dist/bundle/checkpoints.json — definieer het checkpoint
  • package/dist/bundle/locales/checkpoints.en.json — bied een gelokaliseerde testmethodologie

Stap 1: Voeg het checkpoint toe aan checkpoints.json

{
  "id": "custom.1.1",
  "requiredSenses": {
    "sight": true,
    "hearing": false
  },
  "successCriteria": "",
  "automatedRules": [],
  "testingMethodologies": ["desktop", "mobile"],
  "grouping": "custom.1",
  "categories": [],
  "standards": ["custom"]
}

Belangrijke velden:

  • id — unieke identificatie met behulp van je eigen formaat (bijv. custom.1.1, brand.2.3, TT.01.A, s.1.1).
  • successCriteria — lege tekenreeks "" voor niet-WCAG checkpoints (of een eigen formaat zoals "tt-01.A").
  • standards — jouw eigen standaardidentificatie, bijv. ["custom"], ["TT508"], ["smoke"], ["brand"] (niet ["wcag2a"]).
  • testingMethodologies — platforms waar dit checkpoint van toepassing is: desktop, mobile, kiosk, native-mobile-ios, native-mobile-android, pdf, windows-desktop, ms-excel, ms-powerpoint, ms-word.
  • requiredSenses — welke zintuigen nodig zijn om dit checkpoint te testen (sight, hearing: true/false).
  • automatedRules — optionele array van geautomatiseerde regel-ID's (typisch leeg [] voor aangepaste checkpoints).
  • grouping — logische groepering voor organisatie (bijv. "custom.1", "1", "s.1").
  • categories — relevante toegankelijkheidscategorieën (kan leeg zijn [] voor niet-WCAG).
  • terms — optionele array van naslagtermen met id en ordinal properties.

Stap 2: Voeg gelokaliseerde inhoud toe aan checkpoints.en.json

Gebruik het formaat met streepjes id: zet punten om naar streepjes (bijv. custom-1-1, niet custom.1.1).

"custom-1-1": {
  "examples": "<ul>\n  <li>Example 1: Describe a scenario where this applies</li>\n  <li>Example 2: Describe another scenario</li>\n</ul>",
  "related-techniques": {
    "general": "<ul>\n  <li>Technique reference 1</li>\n  <li>Technique reference 2</li>\n</ul>",
    "html": "<ul>\n  <li>HTML-specific technique</li>\n</ul>"
  },
  "testing-methodology": {
    "desktop": "<ol>\n  <li>Step 1 for desktop testing</li>\n  <li>Step 2 for desktop testing</li>\n</ol>",
    "mobile": "<ol>\n  <li>Step 1 for mobile testing</li>\n  <li>Step 2 for mobile testing</li>\n</ol>"
  },
  "name": "Your Custom Checkpoint Name",
  "overview": {
    "general": "General description of what this checkpoint tests and why it matters for accessibility.",
    "html": "HTML-specific description if applicable; otherwise can match general."
  }
}

Gebruik \n voor nieuwe regels en juiste HTML-tags voor lijsten.

Een WCAG checkpoint toevoegen

Bestanden om bij te werken — 6 bestanden voor een complete implementatie van een WCAG-checkpoint:

  1. package/dist/bundle/checkpoints.json — definieer het checkpoint met WCAG-specifieke velden.
  2. package/dist/bundle/locales/checkpoints.en.json — gelokaliseerde testmethodologie, voorbeelden, gerelateerde technieken (gebruik het formaat met streepjes: 1-4-3-a, niet 1.4.3.a).
  3. package/dist/bundle/descriptions.json — probleemomschrijvingen met impactniveaus en checkpoint-referenties.
  4. package/dist/bundle/locales/descriptions.en.json — gelokaliseerde probleemomschrijvingen.
  5. package/dist/bundle/recommendations.json — aanbevelingen voor herstel gekoppeld aan probleemomschrijvingen.
  6. package/dist/bundle/locales/recommendations.en.json — gelokaliseerde aanbevelingsinhoud (titel, beschrijving, stappen, middelen).

Optioneel — handmatige invoer: Als je liever vooraf gedefinieerde beschrijvingen en aanbevelingen overslaat in de JSON-bestanden, kun je deze behandelen bij het loggen van problemen in de tool: selecteer je WCAG-controlepunt, kies Maak je eigen beschrijving in plaats van een vooraf gedefinieerd punt, en voer dan handmatig de beschrijving en (indien nodig) aanbeveling in die is afgestemd op het gevonden probleem.

Stap 1: Definieer het controlepunt

Bestand: package/dist/bundle/checkpoints.json

{
  "id": "1.4.3.a",
  "requiredSenses": {
    "sight": true,
    "hearing": false
  },
  "successCriteria": "1.4.3",
  "automatedRules": ["color-contrast"],
  "testingMethodologies": [
    "desktop", "mobile", "kiosk",
    "native-mobile-ios", "native-mobile-android",
    "pdf", "ms-excel", "ms-powerpoint", "ms-word", "windows-desktop"
  ],
  "grouping": "1.4",
  "categories": ["cat.distinguishable"],
  "standards": ["wcag2aa"]
}

Belangrijke velden:

  • id — WCAG-nummeringspatroon (bijv. "1.4.3.a", "2.1.1.b").
  • successCriteria — WCAG-succescriterianummer (bijv. "1.4.3").
  • standards"wcag2a" (Niveau A), "wcag2aa" (Niveau AA) of "wcag2aaa" (Niveau AAA).
  • automatedRules — reeks van geautomatiseerde regel-ids.
  • grouping — WCAG-richtlijnnummer (bijv. "1.4", "2.1").

Stap 2: Voeg de testmethodologie toe

Bestand: package/dist/bundle/locales/checkpoints.en.json — gebruik het samengestelde formaat (1-4-3-a).

"1-4-3-a": {
  "name": "Color Contrast (Minimum)",
  "overview": {
    "general": "Text and images of text have a contrast ratio of at least 4.5:1, except for large text which has a contrast ratio of at least 3:1.",
    "html": "Text and images of text have a contrast ratio of at least 4.5:1, except for large text which has a contrast ratio of at least 3:1."
  },
  "examples": "<ul>\n  <li>Gray text on white background with insufficient contrast</li>\n  <li>Blue text on blue background that doesn't meet requirements</li>\n</ul>",
  "testing-methodology": {
    "desktop": "<ol>\n  <li>Identify all text content on the page</li>\n  <li>Use a color contrast analyzer tool</li>\n  <li>Ensure normal text has at least 4.5:1 contrast ratio</li>\n  <li>Ensure large text has at least 3:1 contrast ratio</li>\n</ol>",
    "mobile": "<ol>\n  <li>Test on a mobile device under various lighting conditions</li>\n  <li>Use mobile accessibility testing tools</li>\n  <li>Verify contrast ratios meet WCAG requirements</li>\n</ol>",
    "assistive-technology": "<p><strong>Screen reader testing is optional for this checkpoint.</strong></p>\n<p><strong>Using NVDA:</strong></p>\n<ol>\n  <li>Navigate through text content</li>\n  <li>Verify text readability</li>\n</ol>"
  },
  "related-techniques": {
    "general": "<ul>\n  <li><a href=\"https://www.w3.org/WAI/WCAG22/Techniques/general/G18\">G18: Ensuring contrast ratio of at least 4.5:1</a></li>\n</ul>",
    "html": "<ul>\n  <li><a href=\"https://www.w3.org/WAI/WCAG22/Techniques/css/C21\">C21: Specifying line spacing in CSS</a></li>\n</ul>"
  }
}

Stap 3: Voeg probleemomschrijvingen toe

Bestand: package/dist/bundle/descriptions.json

{
  "id": "insufficient-color-contrast",
  "data": [
    {
      "type": "issue",
      "impact": 4,
      "checkpoint": "1.4.3.a",
      "standards": ["wcag2aa"],
      "references": [
        {
          "standards": ["wcag2aa"],
          "checkpoint": "1.4.3.a"
        }
      ],
      "testingMethodologies": ["desktop", "mobile"]
    }
  ]
}

Stap 4: Voeg gelokaliseerde probleemomschrijvingen toe

Bestand: package/dist/bundle/locales/descriptions.en.json

Voeg een object toe voor de nieuwe beschrijving:

"insufficient-color-contrast": {
  "shortText": "Insufficient color contrast",
  "issueDescText": "Text does not have sufficient contrast against its background to meet WCAG 2.1 AA requirements."
}

Stap 5: Voeg aanbevelingen toe

Bestand: package/dist/bundle/recommendations.json

Gebruik het samengestelde formaat (1-4-3-a) en voeg dit toe aan de aanbevelings-id.

{
  "id": "insufficient-color-contrast-fix-1-4-3-a",
  "data": [
    {
      "type": "recommendation",
      "description": "insufficient-color-contrast"
    }
  ]
}

Stap 6: Voeg aanbevelingsinhoud toe

Bestand: package/dist/bundle/locales/recommendations.en.json

"insufficient-color-contrast-fix-1-4-3-a": {
  "title": "Improve Color Contrast",
  "description": "Increase the contrast ratio between text and background colors to meet WCAG 2.1 AA requirements.",
  "steps": [
    "Use a color contrast analyzer to identify insufficient contrast",
    "Adjust text color, background color, or both to achieve a minimum 4.5:1 ratio",
    "For large text (18pt+ or 14pt+ bold), ensure a minimum 3:1 ratio",
    "Test the changes across different devices and lighting conditions"
  ],
  "resources": [
    "WebAIM Color Contrast Checker",
    "W3C Color Contrast Analyzer",
    "Chrome DevTools Accessibility Panel"
  ]
}

Een specifiek controlepunt verwijderen

Gebruik deze instructies als er een specifiek controlepunt is dat je team niet wil testen en rapporteren.

Bestanden bijgewerkt:

  • package/dist/bundle/checkpoints.json
  • package/dist/bundle/descriptions.json
  • package/dist/bundle/recommendations.json
  • package/dist/bundle/locales/checkpoints.en.json
  • package/dist/bundle/locales/recommendations.en.json

Stappen:

  1. Zoek in checkpoints.json naar het specifieke controlepunt (bijv. 1.2.1.b). Verwijder het hele object dat aan dit controlepunt is gekoppeld, terwijl je ervoor zorgt dat de JSON geldig blijft. Sla het bestand op.
  2. Zoek in descriptions.json naar het specifieke controlepunt (bijv. 1.2.1.b). Verwijder alleen het object dat het controlepunt onder de regel gebruikt, terwijl je ervoor zorgt dat de JSON geldig blijft. Een enkele regel kan van toepassing zijn op meerdere controlepunten — verwijder alleen het object voor het controlepunt dat je verwijdert; verwijder niet de complete regel. Sla het bestand op.
  3. Zoek in recommendations.json naar het specifieke controlepunt (bijv. 1.2.1.b). Verwijder elk object dat aan dit controlepunt is gekoppeld (er kunnen er meer dan één zijn), terwijl je ervoor zorgt dat de JSON geldig blijft. Sla het bestand op.
  4. Zoek in checkpoints.en.json naar het specifieke controlepunt met behulp van het samengestelde formaat (bijv. 1-2-1-b). Verwijder het hele object, terwijl je ervoor zorgt dat de JSON geldig blijft. Sla het bestand op.
  5. Zoek in recommendations.en.json naar het specifieke controlepunt met behulp van het samengestelde formaat (bijv. 1-2-1-b). Verwijder elk object dat aan dit controlepunt is gekoppeld (er kunnen er meer dan één zijn), terwijl je ervoor zorgt dat de JSON geldig blijft. Sla het bestand op.

Wijzigingen terugsturen naar Deque

Wanneer de bewerkingen voltooid en gevalideerd zijn:

  1. Bevestig dat elk bewerkt bestand nog steeds JSON-validatie doorstaat (zie Voordat je begint).
  2. Bevestig dat de wijzigingen overeenkomen met de afgesproken scope.
  3. Stuur de volledige package map terug naar Deque in de originele structuur (stuur niet alleen individuele bestanden).

Deque zal de versie toewijzen, het pakket samenstellen, het koppelen aan de juiste axe-core versie, en het inzetten op een testinstantie voor verificatie. Nadat je team de wijzigingen op de testinstantie heeft geverifieerd en goedgekeurd, promoot Deque de methodologie naar je productie instantie.

Ondersteuning

Voor vragen over dit proces, de afgesproken wijzingsscope, of om aanvullende taalondersteuning aan te vragen, neem contact op met je Deque-contactpersoon.