Axe DevTools voor Web Cucumber

De axe-devtools-cucumber-gem biedt aangepaste stapspecificaties om te beoordelen of een gegeven pagina axe-klaar is.

Deze gem breidt uit op de stappen die worden aangeboden door de readme van de axe-core-cucumber gem.

Installatie en Gebruik

Zorg ervoor dat u toegang heeft tot Deque's registry. Zo niet, refer to setup.

• Voeg axe-devtools-cucumber toe aan uw Gemfile of gemspec-bestand en voer bundle install uit.

gem "axe-devtools-cucumber"

spec.add_dependency "axe-devtools-cucumber"

• Benodigde stapspecificaties worden aangeboden door de gem. Meestal kunt u dit doen door toe te voegen aan een bestaand Cucumber-configuratiebestand onder features/support/env.rb.

require 'axe-cucumber-steps'

• Gebruik met de WebDriver naar keuze.

API

Stap - Wees axe-klaar (be axe clean)

De stap be axe clean is de kerncomponent van de integratie. Het is een volledige stap op zichzelf en zal verifiëren dat de momenteel geladen pagina axe-klaar is met behulp van de standaardconfiguratie van axe.run (het hele document wordt gecontroleerd met de standaardregels).

Then the page should be axe clean

Stap - Laat je toetsen op toegankelijkheid (be audited for accessibility)

Deze stap stelt u in staat om de toegankelijkheid van uw site te controleren zonder dat de testreeks faalt. Voor geïdentificeerde violations zullen de matchers het testvoorbeeld converteren naar pending en de gedetailleerde overtredingen weergeven.

Then the page should be audited for accessibility [including]
[excluding] [according to/according to ruleset] [checking rules/checking-only-rules]
[skipping rules] [logging results for]

Clausules

Clausules zijn koppelbare methoden voor de be axe clean- en be audited for accessibility-stapspecificaties.

Configureerbare clausules zorgen voor meer granulariteit bij testen en verwachtingen.

within- Insluitclausule

De insluitclausule (within "#selector") specificeert welke elementen van de pagina gecontroleerd moeten worden. Een geldige CSS selector moet worden verstrekt en tussen dubbele aanhalingstekens worden gezet. Samengestelde selectoren kunnen worden gebruikt om meerdere elementen te selecteren, bijvoorbeeld within "#header, .footer". Voor meer informatie, zie de context parameter documentation.

Then the page should be axe clean within "#selector"

excluding- Uitsluitclausule

De uitsluitclausule (excluding "#selector") specificeert welke elementen van het document genegeerd moeten worden. Een geldige CSS selector moet worden verstrekt en tussen dubbele aanhalingstekens worden gezet. Samengestelde selectoren kunnen worden gebruikt om meerdere elementen te selecteren, bijvoorbeeld excluding "#widget, .ad". Voor meer informatie, zie de context parameter documentation.

Then the page should be audited for accessibility excluding "#selector"

Indien gewenst kan een puntkomma (;) of het woord but worden gebruikt om de uitsluitclausule te scheiden van de insluitclausule (indien aanwezig).

Then the page should be audited for accessibility within "main"; excluding "aside"
Then the page should be axe clean within "main" but excluding "aside"

according to- Toegankelijkheidsstandaard (Tag) clausule

De tagclausule specificeert welke toegankelijkheidsstandaard (of standaarden) moet worden gebruikt om de pagina te controleren. De toegankelijkheidsstandaarden worden gespecificeerd per naam (tag). Meerdere standaarden kunnen worden gespecificeerd wanneer ze door middel van komma's gescheiden worden, bijvoorbeeld according to: wcag2a, section508. De acceptabele tag names are documented evenals een complete listing of rules die bij elke tag hoort.

Then the page should be audited for accessibility according to: tag-name

Indien gewenst kan een puntkomma (;) worden gebruikt om de tagclausule te scheiden van de voorafgaande clausule.

Then the page should be axe clean within "#header"; according to: best-practice

checking- Controleregelsclausule

De controleregelsclausule specificeert welke aanvullend regels uitgevoerd moeten worden (naast de gespecificeerde tags, indien van toepassing, of de standaardregels). De regels worden gespecificeerd door komma-gescheiden regel-ID's.

Then the page should be axe clean checking: ruleId

Voor een lijst met geldige regel-ID's, zie de rules documentation.

Indien gewenst kan een puntkomma (;) of het woord and worden gebruikt om de controleregelsclausule te scheiden van de voorafgaande clausule.

Then the page should be axe clean according to: wcag2a; checking: color-contrast
Then the page should be audited for accessibility according to: wcag2a and checking: color-contrast

checking only- Exclusieve Regelsclausule

Deze clausule is niet echt een aparte clausule. Maar door het woord only toe te voegen aan de controleregelsclausule, kan de betekenis van de stap worden veranderd. Zoals hierboven beschreven, specificeert de controleregelsclausule standaard aanvullend regels om uit te voeren. Als het woord only wordt gebruikt, dan worden alleen de opgegeven regels gecontroleerd.

Then the page should be axe clean checking only: ruleId

skipping- Overschrijfregelsclausule

De overschrijfregelsclausule specificeert welke regels overgeslagen moeten worden. Dit stelt in staat om een toegankelijkheidsstandaard te verstrekken (via de tagclausule) terwijl een specifieke regel genegeerd wordt. De regels worden gespecificeerd door komma-gescheiden regel-ID's.

Then the page should be audited for accessibility skipping: ruleId

Voor een lijst met geldige regel-ID's, zie de rules documentation.

U kunt een puntkomma (;) of het woord but gebruiken om de overschrijfregelsclausule te scheiden van de voorafgaande clausule, zoals hieronder getoond:

Then the page should be axe clean according to: wcag2a; skipping: accesskeys
Then the page should be audited for accessibility according to: wcag2a but skipping: accesskeys

Clausules die alleen beschikbaar zijn voor stap - Laat je toetsen op toegankelijkheid

De be audited for accessibility-matcher biedt ondersteuning voor twee aanvullende clausules.

according to ruleset- Regelssetclausule

De regelssetclausule [according to ruleset] helpt om een enkele regelsset te specificeren (bijvoorbeeld, 508, wcag2, wcag21) die gebruikt zal worden om de pagina te controleren.

Then the page should be axe clean according to ruleset: wcag2

logging results- Logresultatenclausule

Om resultaten van de basismatcher en clausules te loggen, roep de koppelbare methode logging results aan zoals hieronder getoond. De logging results for: report_name-clausule stelt in staat de naam van het rapport dat aan het einde van de stapsuitvoering wordt gegenereerd te specificeren.

Then the page should be audited for accessibility logging results for: axe_report_of_my_site

Interoperabiliteit tussen clausules

Alle beschreven clausules kunnen worden gecombineerd en gemengd met method chaining. Hieronder staan enkele voorbeelden.

Then the page should be audited for accessibility within "main, header" but excluding "footer"

Then the page should be axe clean excluding "#sidebar" according to: wcag2a, wcag2aa but skipping: color-contrast

Then the page should be audited for accessibility checking only: document-title, label

Then the page should be axe clean according to: best-practice and checking: aria-roles, definition-list

Geavanceerd API-gebruik

Raadpleeg advanced usage om te zien hoe u de API kunt configureren voor:

• Aangepaste regels
• Aangepast pad naar axe-bron
• Gebruik opname
• Rapportage