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 beleidsregels die extra of minder controles vereisen.
  • Interne richtlijnen om specifieke tools te gebruiken bij het uitvoeren van tests.
  • Beleidsbeslissingen die verschillende probleemkenmerken veranderen (impact, beschrijvingen, aanbevelingen).

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

Hoe Dit Werkt: Rollen en Workflow

De axe Auditor-instantie van uw organisatie wordt gehost en beheerd door Deque. Dat betekent dat Deque verantwoordelijk is voor de installatie, volgorde van versies, 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 zorgt voor al deze zaken namens u.

Het end-to-end proces is:

Stap Eigenaar Actie
1 Deque Voorziet uw team van de huidige methodologiebundel (DequeWay).
2 Klant Pakt het pakket uit op een werkplek en produceert een map genaamd package.
3 Klant Maakt een back-up van de originele package map voordat er wijzigingen worden aangebracht.
4 Klant Brengt de overeengekomen methodologie wijzigingen aan volgens de onderstaande secties.
5 Klant Valideert de bewerkte JSON-bestanden (zie Voordat u begint).
6 Klant Stuurt de gehele package map terug naar Deque, in dezelfde structuur als waarin deze was geleverd.
7 Deque Versies, verpakt en koppelt de methodologie aan de juiste axe-core versie, en implementeert het naar een testinstantie voor verificatie.
8 Klant Verifieert de wijzigingen op de testinstantie en bevestigt de goedkeuring.
9 Deque Promoveert de geverifieerde methodologie naar uw productie-instantie.

Scope opmerking: Dit document somt alle beschikbare aanpassingstypes op voor volledigheid. De specifieke wijzigingen die uw team zal maken, moeten overeenkomen met de overeengekomen veranderscope.

Voordat u begint

1. Maak een back-up van het origineel. Voordat u iets bewerkt, maakt u een kopie van de uitgepakte package map. Als een bewerking het pakket breekt, 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 onderling afhankelijk. Het bewerken van een bestand dat niet is vermeld voor een bepaalde wijziging — of het missen van een bestand dat zijn is vermeld — kan resulteren in een pakket dat faalt pas nadat het weer bij Deque is aangekomen.

3. Valideer elk bestand dat u aanraakt. Elk bestand is JSON en moet geldig JSON blijven na de bewerking (geen komma's aan het einde, evenwichtige accolades/haakjes). Valideer voordat u verzendt:

# 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 methode in aanvullende talen vereist, laat het Deque weten — Deque maakt taalsupport mogelijk tijdens de configuratie. In dat geval moet elke wijziging die u in een .en.json bestand aanbrengt ook worden doorgevoerd in het overeenkomstige taalbestand (bijv. het .nl.json equivalent) voor elke extra taal.

Toegestane Updates

Werk de testmethodologie voor een specifiek controlepunt bij

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. Breng de juiste updates aan op elk vermelde type asset onder testing-methodology.
  4. Sla het bestand op in de huidige locatie.

Opmerking: De naam van het controlepunt die zichtbaar is 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.

Werk de impact van een regel bij

U kunt het impactniveau (blokkeerder, kritiek, ernstig, gemiddeld, gering) voor elk probleem in axe Auditor wijzigen. Maar als u de standaard-impact voor een regel moet wijzigen, volg dan deze instructies.

Impacts in axe Auditor worden opgeslagen op regel-niveau, niet op het niveau van WCAG Succescriteria of controlepunten. 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 veroorzaakt door de schending van deze regel over de alles WCAG Succescriteria die aan de regel zijn verbonden.

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 in de huidige locatie.

Impactwaardetoewijzingen

Impactwaarde Impact in axe Auditor
5 Blokkeerder
4 Kritiek
3 Ernstig
2 Gemiddeld
1 Gering

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

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

⚠️ Deque intern — oplossen vóór publicatie: De bestandslijst voor deze sectie verwijst naar drie controlepunt-gerelateerde paden die inconsistent 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 echt verschillende gecompileerde bestanden zijn, of dat dit padfouten zijn, en werk dan de lijst dienovereenkomstig bij en verwijder deze opmerking.

toon 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 aan voor de standaard in standards.json. De gemakkelijkste aanpak is om het gehele object voor wcag21aa te kopiëren en onderaan het bestand toe te voegen.
  2. Wijzig de id van het nieuw gekopieerde object naar iets unieks dat de standaard die het vertegenwoordigt aangeeft.
  3. Werk de rubric-array bij voor het nieuwe object om alle onderliggende teststandaarden weer te geven die deel uitmaken van deze nieuwe standaard.
  4. Voeg in descriptions.json voor alle regels die met uw nieuwe standaard geassocieerd zijn, de id van de nieuwe standaard (van standards.json) toe aan de standards-array.
  5. Voeg in testingMethodologies.json de id van de nieuwe standaard toe onder de standards-array voor elk type digitaal asset waarop deze standaard van toepassing is.
  6. Voeg in standards.en.json 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. Werk in dist/checkpoints.json de standards-array bij onder elke probleembeschrijving voor de toepasselijke controlepunten.
  8. Werk in issue-descriptions.json de standards-array bij voor alle toepasselijke regelobjecten.
  9. Werk in dist/bundle/checkpoints.json de standards-array van elk toepasselijk controlepunt bij met de juiste standaard.

Werk de korte en lange probleembeschrijvingen voor specifieke regels bij

Gebruik deze instructies om de tekst (kort) van de probleembeschrijving-selectie en de lange beschrijving van het probleemtype voor elke regel bij te werken. Een enkele regel kan meerdere WCAG Succescriteria beïnvloeden — door deze tekst te wijzigen beïnvloedt u de alles Succescriteria waarmee het is verbonden.

Lange en korte beschrijving

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

Stappen:

  1. Zoek in descriptions.en.json naar de specifieke regel (bijv. alt-text-dynamic-image-inconsistent).
  2. Werk de tekst bij voor shortText (Korte Probleembeschrijving) en issueDescText (Lange Probleembeschrijving) 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 overeen te komen met uw beleid, gebruik dan de volgende instructies.

herstel aanbevelingen

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

Stappen:

  1. Zoek in recommendations.en.json naar de specifieke regel (bijvoorbeeld alt-text-dynamic-image-inconsistent) en checkpoint combinatie waarvoor je de reparatiebibliotheek wilt wijzigen.
  2. Werk de tekst bij voor recommendationType (Aanbevelingstechniek), rule, howtofix, en background (secties van de aanbeveling om te verbeteren) indien van toepassing.
  3. Sla het bestand op in de huidige locatie.

Verwijder Digitale Activatypen

Gebruik dit wanneer een bepaald activatype niet van toepassing is op jouw organisatie (bijvoorbeeld als PDF- of Android-testen 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ënbestand

Bestand: dist/bundle/testingMethodologies.json

Vind en verwijder het hele object voor de methode die je 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 taalbestand

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

Verwijder hetzelfde methodologie-object uit dit bestand.

Voeg een Nieuw Digitaal Activatype Toe

Gebruik dit om een nieuw digitaal activatype toe te voegen — bijvoorbeeld een web-app of macos methodologie. Het onderstaande voorbeeld maakt gebruik van web-app; vervang het door je eigen asset type 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 checkpointinhoud met testmethodologie secties
  • dist/bundle/checkpoints.json — belangrijkste checkpointgegevens
  • dist/bundle/descriptions.json — probleemomschrijvingen met testmethodologie verwijzingen
  • dist/bundle/schemata.json — schema-definities met testmethodologie verwijzingen

Stap 1: Voeg toe aan het testmethodologieënbestand

Bestand: dist/bundle/testingMethodologies.json

Voeg het nieuwe methodologie-object 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 taalbestand

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

Voeg hetzelfde methodologie-object toe aan dit bestand.

Stap 3: Voeg verwijzingen toe aan het checkpointbestand

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 testmethodologie inhoud toe aan het checkpoint taalbestand

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

Voor elk checkpoint dat de nieuwe methodologie moet ondersteunen, voeg de testmethodologie inhoud 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 verwijzingen toe aan het beschrijvingsbestand

Bestand: dist/bundle/descriptions.json

Voor probleemomschrijvingen die de nieuwe methodologie moeten ondersteunen, voeg deze 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 verwijzingen 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

Voeg een Niet-WCAG Checkpoint Toe

Belangrijk: Niet-WCAG checkpoints ondersteunen niet vooraf gedefinieerde beschrijvingen of aanbevelingen via descriptions.json en recommendations.json niet. Bij het registreren 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 — alleen 2:

  • package/dist/bundle/checkpoints.json — definieer het checkpoint
  • package/dist/bundle/locales/checkpoints.en.json — bied 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 (bijvoorbeeld, custom.1.1, brand.2.3, TT.01.A, s.1.1).
  • successCriteria — lege string "" voor niet-WCAG checkpoints (of een aangepast formaat zoals "tt-01.A").
  • standards — je eigen standaardidentificatie, bijvoorbeeld, ["custom"], ["TT508"], ["smoke"], ["brand"] (niet ["wcag2a"]).
  • testingMethodologies — platforms waarop 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 (doorgaans leeg [] voor aangepaste checkpoints).
  • grouping — logische groepering voor organisatie (bijvoorbeeld, "custom.1", "1", "s.1").
  • categories — relevante toegankelijkheidscategorieën (kan leeg zijn [] voor niet-WCAG).
  • terms — optionele array van verklarende termenreferenties met id en ordinal eigenschappen.

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

Gebruik het met koppeltekens-id-formaat: zet puntjes om in koppeltekens (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 de juiste HTML-tags voor lijsten.

Een WCAG-controlepunt toevoegen

Bestanden om bij te werken — 6 bestanden voor een volledige implementatie van het WCAG-controlepunt:

  1. package/dist/bundle/checkpoints.json — definieer het controlepunt met WCAG-specifieke velden.
  2. package/dist/bundle/locales/checkpoints.en.json — gelokaliseerde testmethodologie, voorbeelden, gerelateerde technieken (gebruik het id-formaat met koppeltekens: 1-4-3-a, niet 1.4.3.a).
  3. package/dist/bundle/descriptions.json — beschrijvingen van problemen met impactniveaus en controlepuntverwijzingen.
  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 inhoud van aanbevelingen (titel, beschrijving, stappen, bronnen).

Optioneel — handmatige invoer: Als je ervoor kiest om vooraf gedefinieerde beschrijvingen en aanbevelingen niet aan de JSON-bestanden toe te voegen, kun je ze afhandelen bij het loggen van problemen in de tool: selecteer je WCAG-controlepunt, kies Maak je eigen beschrijving in plaats van een vooraf gedefinieerd item, en voer vervolgens handmatig de beschrijving en (indien nodig) aanbevelingen in die zijn 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 — lijst van geautomatiseerde regel-id's.
  • grouping — WCAG-richtlijnnummer (bijv. "1.4", "2.1").

Stap 2: Voeg de testmethodologie toe

Bestand: package/dist/bundle/locales/checkpoints.en.json — gebruik het format met koppeltekens (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 voor de nieuwe beschrijving toe:

"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 format met koppeltekens (1-4-3-a) en voeg het toe aan de aanbevelings-id.

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

Stap 6: Voeg inhoud van aanbevelingen 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"
  ]
}

Verwijder een specifiek controlepunt

Gebruik deze instructies als er een specifiek controlepunt is dat je team niet wilt 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 gehele object dat bij dit controlepunt hoort en behoud een geldig JSON-bestand. 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 en behoud een geldig JSON-bestand. Een enkele regel kan op meerdere controlepunten van toepassing zijn — 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) en behoud een geldig JSON-bestand. Sla het bestand op.
  4. Zoek in checkpoints.en.json naar het specifieke controlepunt met het format met koppeltekens (bijv. 1-2-1-b). Verwijder het gehele object en behoud een geldig JSON-bestand. Sla het bestand op.
  5. Zoek in recommendations.en.json naar het specifieke controlepunt met het format met koppeltekens (bijv. 1-2-1-b). Verwijder elk object dat aan dit controlepunt is gekoppeld (er kunnen er meer dan één zijn) en behoud een geldig JSON-bestand. Sla het bestand op.

Wijzigingen terugsturen naar Deque

Wanneer de bewerkingen voltooid zijn en gevalideerd:

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

Deque zal de versie toewijzen, het pakket verpakken, het in kaart brengen naar de juiste axe-core-versie, en het inzetten naar 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 wijzigingsscope, of om aanvullende taalondersteuning aan te vragen, neem contact op met je Deque-contactpersoon.