Aangepaste Regels Gebruiken

Overzicht van Aangepaste Regels in de axe Expert-extensie

Wanneer je wilt dat de axe Expert-tool webpagina's en applicaties analyseert aan de hand van regels die specifiek zijn voor de unieke behoeften van jouw organisatie, is dit mogelijk met de functie voor Aangepaste Regels op het Rules paneel. Klikken op het item Regels in het hoofdmenu van axe Expert (uitklapmenu nabij het axe Expert Extension-logo bovenaan het linker paneel) opent een Rules paneel waar een knop 'Voeg aangepast regelsysteem toe' wordt aangeboden voor het tonen van een formulier in het rechter paneel om een set aangepaste regels in te dienen. Het eenvoudige formulier bestaat uit twee tekstinvoervelden en een actieknop die je toestaan aangepaste regels in te stellen die kunnen worden geselecteerd voor uitvoering in de geautomatiseerde engine wanneer een geladen pagina wordt geanalyseerd op het Analysepaneel.

Net als bij het analyseren van een pagina met de regelsystemen van axe Expert, zullen de resultaten elke overtreding van je aangepaste regels tonen die worden gevonden, samen met de informatie die je hebt gespecificeerd in het aangepaste regelsysteem (Doel, HTML-bron, samenvatting van herstel, Meer info help-link, enz.). Alle andere actieopties die beschikbaar zijn bij standaardregels gelden ook voor je overtredingen van aangepaste regels (Inspecteer, Markeer, Exporteer, Upload, enz.). Er is een limiet van vijf aangepaste regelsystemen die tegelijk zijn toegestaan.

1. Voeg een regelsysteem toe: In de sectie Custom rulesets van het linker paneel van Rules paneel, biedt een +Add a ruleset commando je een formulier in het rechter paneel om een aangepaste set regels in te dienen.
2. Naam voor Aangepaste Regels (alleen alfanumeriek): Dit zal de naam zijn van het regelsysteem dat verschijnt in de sectie Standaarden van het Instellingen tabblad. Het is belangrijk om zowel de conventies te volgen (alfanumeriek, geen spaties) als ervoor te zorgen dat de naam betekenisvol en makkelijk herkenbaar is als een selectieoptie.
3. Voer JSON in rules.textareaInstructions: JSON (JavaScript Object Notation) is de tekstgebaseerde standaard waaraan de inhoud moet voldoen om te werken met Firefox's HTML 2.0 browserextensie. Voor meer informatie, zie de Voorbeeld hieronder.
4. REGELSET OPSLAAN EN GEBRUIKEN knop: Zorgt ervoor dat de aangepaste regels een selecteerbare optie worden in het menu van het linker zijbalkpaneel van het Rules paneel. Voor meer informatie, zie Selecteer een Regelsysteem.

Voorbeeld van Aangepaste Regel

De voorbeeldcode die volgt kan dienen als een werkend voorbeeld van een correct geformatteerd axe Expert Custom Rule JSON-bestand.

{
  "checks": [
    {
      "id": "test",
      "options": ["test"],
      "evaluate": "function() { return false; }",
      "metadata": {
        "impact": "minor",
        "messages": {
          "pass": "how did you pass",
          "fail": "there is no way to pass"
        }
      }
    }
  ],
  "rules": [
    {
      "id": "test",
      "metadata": {
        "description": "Will always fail",
        "help": "There is no way to make this pass! It is for testing",
        "helpUrl": "https://foo.com/bar"
      },
      "selector": "html",
      "any": [],
      "all": ["test"],
      "none": [],
      "tags": ["wcag2aa"]
    }
  ]
}

Aangepaste Regelsystemen van axe Monitor Projecten: Na inloggen bij axe Monitor en het selecteren van een project, worden alle aangepaste regelsystemen die aan dat project zijn gekoppeld automatisch geladen in het Rules paneel en beschikbaar gemaakt voor selectie.

Dien aangepaste regels in

Wanneer je aangepaste regels wilt indienen voor toekomstig gebruik in de axe Expert Extension, volg dan deze eenvoudige stappen. Het indienen van aangepaste regels wordt gedaan door een naam voor het regelsysteem op te geven voor toekomstige selectiedoelen en inhoud van een correct geformatteerd JSON-tekstbestand in te plakken in tekstinvoervelden, waarna je op een knop klikt om ze op te slaan en te gebruiken.

Om aangepaste regels in te dienen:

1. Open DevTools en selecteer axe Expert. Selecteer Regels in het hoofdmenu van axe Expert.

2. Selecteer in het linker paneel + Voeg een regelsysteem toe in de sectie Aangepaste Regelsystemen van het menu. Het regelsysteemformulier wordt in het rechter paneel weergegeven.

3. Voer in het veld Naam van Aangepaste Regels de gewenste alfanumerieke naam in zonder spaties, naar wens.

   Dit verschijnt in de sectie Aangepaste Regelsystemen van het linker paneel van het Rules paneel, dus de naam moet betekenisvol en gemakkelijk herkenbaar zijn voor selectie.

4. Plak in het veld Voer JSON in de inhoud van je aangepaste regels .json-tekstbestand van het virtuele klembord. Grijp en sleep de rechter, onderhoek van het veld om het zichtbare gebied te vergroten, indien gewenst.

5. Selecteer SAVE AND USE RULESET.

   

   De naam die je hebt ingevoerd verschijnt in de sectie Aangepaste regelsystemen in het linker paneel, en het verschijnt bovenaan het rechter paneel, in het veld Regelsysteem:. Daarnaast verschijnen knoppen om het regelsysteem te verwijderen of te gebruiken onderaan het formulier in het rechter paneel.

   Selecteer in het rechter paneel Analyze now.

   

   De naam van het aangepaste regelsysteem verschijnt in het linkermenu voor Regels voorafgegaan door een vinkje om aan te geven dat het het momenteel geselecteerde regelsysteem is dat wordt gebruikt bij het uitvoeren van analyses.

Analyseer een pagina op Schendingen van Toegankelijkheidsregels

Het starten van een toegankelijkheidsanalyse in de axe Expert Extension doe je door naar het Analysepaneel te navigeren en vervolgens op de Analyseer knop te klikken. Het analyseproces produceert een bericht dat het totale aantal gevonden schendingen van toegankelijkheidsregels op de pagina aangeeft en een resultatensectie die de geïdentificeerde regelschendingen en het totale aantal geïdentificeerde schendingen weergeeft. Activering van een rij in het linkerresultatenpaneel toont details in het hoofdinhoudspaneel aan de rechterkant. Deze actie initialiseert ook de schending Vorige en Volgende pijlen knoppen om bovenaan het inhoudspaneel te verschijnen zodat je kunt navigeren van de ene schending naar de volgende voor elke geselecteerde regel.

Analyseer een pagina op regelschendingen:

1. Met de axe Expert-tab geselecteerd, selecteer Analyseer in het hoofdmenu op het linker paneel rechts van het axe Expert Extension-logo. Het Analysepaneel verschijnt.

2. In het inhoudspaneel activeer ANALYZE. Afhankelijk van hoe je de ontwikkelaarstools hebt vastgemaakt of je browservenster hebt aangepast, bevindt dit zich meestal in het midden van het linker paneel van het Analysepaneel.

   Het Analysescherm kan tijdelijk een statusbericht weergeven dat leest Analyzing...please wait totdat de analyse van de pagina tegen het geselecteerde regelsysteem is voltooid.

   Onder het axe Expert Extension-logo wordt het totale aantal gevonden schendingen weergegeven, evenals het aantal problemen dat handmatige controle vereist. Daarnaast worden een dropdown-contextmenu en een Run again link rechts van de totale aantallen weergegeven. Een tweekolommentabel die de korte naam van elke regel toont met de rechterkolom die het aantal gevonden overtredingen van elke regel weergeeft, wordt onder het dropdown-contextmenu weergegeven.

   

3. In de rules violated sectie (linker paneel), klik op een rule rij.

   

   Het inhoudspaneel aan de rechterkant wordt vernieuwd om de eerste overtreding van die regel weer te geven. In de inhoudsweergave zijn de Target, HTML en Summary (How to Fix the Problem) secties van informatie opgenomen, evenals Inspect en Highlight links, een contextmenu (dat opties bevat voor Export, Scope, Upload en Download), en helemaal onderaan rechts een naar links uitklappende pijltjestoets om de toepasselijke Standaarden (regelsystemen) voor de geselecteerde regel weer te geven. Voor meer gedetailleerde informatie over elk onderdeel dat in het regel-overtredingspaneel wordt weergegeven, verwijzen we naar de beschrijvingen in het overzicht in het Analyseer onderwerp. Navigatieknoppen voor overtredingen, Vorige < en Volgende >, verschijnen bovenaan het paneel zodat je kunt navigeren tussen de overtredingen voor de geselecteerde regel. Daarnaast wordt de relevante HTML met de overtreding automatisch gemarkeerd op de geteste pagina.

4. Klik op Volgende (>) om naar de volgende overtreding van de momenteel geselecteerde regel te navigeren, of kies een andere regel uit het linker overtreden regelsresultatenpaneel, naar wens.

   

Een aangepaste regelset verwijderen

Verwijder een aangepaste regelset uit het Rules-paneel wanneer je een set van aangepaste regels niet meer nodig hebt. Selecteer de regel om te verwijderen in het Rules-paneel en klik op een knop om te verwijderen.

Als je wat van de inhoud in een toekomstige aangepaste regelset wilt hergebruiken, zorg er dan voor dat je de inhoud van het JSON-bestand opslaat vóór verwijdering, aangezien deze procedure resulteert in een permanente, onomkeerbare verwijdering.

Om een aangepaste regelset te verwijderen:

1. Zorg ervoor dat de set die je wilt verwijderen is aangevinkt (geselecteerd) onderaan de optielijst in de Custom rulesets-sectie in het linkerpaneel van het Rules-paneel.
2. Klik op DELETE RULESET.

De set wordt verwijderd uit het menu van het linkerpaneel en is niet langer beschikbaar voor selectie.