À propos d'Axe DevTools pour les API Web
Introduction aux Axe DevTools pour les API Web pour Node.js et JavaScript, C#, Java, Python, et Ruby.
Deque propose des liaisons API pour le développement web et les langages de script, y compris Node.js et JavaScript, C#, Java, Python, et Ruby. Ces API vous permettent de détecter des défauts d'accessibilité sur vos sites web dans le cadre de vos tests automatisés existants ou de vos builds d'intégration continue (CI).
Commencer
Consultez Axe DevTools pour des exemples Web pour un catalogue de projets exemples pré-écrits sur GitHub qui démontrent comment utiliser les API. Vous pouvez cloner ces projets pour commencer immédiatement avec un exemple fonctionnel. Consultez le fichier README.md de chaque projet pour des instructions détaillées afin de débuter.
Documentation API
Axe DevTools pour le Web offre un support pour divers langages et frameworks, et les liens suivants fournissent la documentation :
Notions de base pour les nouveaux développeurs Deque
Si vous débutez avec l'utilisation des API Axe DevTools pour le Web, il y a quelques sujets que vous pourriez vouloir connaître avant de commencer.
Installation
Pour obtenir les bibliothèques et packages de Deque, plusieurs options s'offrent à vous. Consultez les rubriques suivantes pour plus d'informations sur l'installation :
- Node.js et JavaScript
- C#
- Java
- Python via pip ou Python via un bundle
- Ruby
Le jeu de règles par défaut
Sauf si vous configurez autre chose, chaque test Axe DevTools pour Web API se fait selon WCAG 2.1 Niveau AA, l'identifiant du jeu de règles wcag2.1. Les règles étiquetées best-practice et les règles étiquetées experimental sont désactivées dans ce paramètre par défaut. Consultez Personnaliser les règles pour savoir ce que couvre le paramètre par défaut, comment activer les meilleures pratiques dans chaque langue, et comment choisir une norme différente.
Analyse des iframes
Le contenu à l'intérieur des éléments <iframe> est analysé avec le reste de la page, dans toutes les langues prises en charge. Voir Analyse des iframes pour savoir comment les résultats des cadres sont rapportés et comment limiter une analyse à un élément à l'intérieur d'un cadre.
Formation sur l'accessibilité
Consultez Deque University pour plus d'informations et de formations sur l'accessibilité et les normes d'accessibilité. Apprendre sur l'accessibilité vous aidera à résoudre les problèmes d'accessibilité plus tôt dans le cycle de vie du développement logiciel, ce qui est plus économique.
axe-core
La bibliothèque open-source axe-core est la base de tous les paquets et bibliothèques Axe DevTools pour le Web. Vous pouvez en lire plus à son sujet dans le dépôt GitHub axe-core.
Les packages API de Deque (à l'exception des packages Node.js Reporter) ne suivent pas strictement les règles de Versionnage Sémantique. Les packages verrouillent leurs numéros de version majeure et mineure sur ceux de la dépendance axe-core, seul le numéro de version correctif pouvant différer. (Par exemple, si la version de l'API est 4.7.2, alors la version axe-core utilisée par le package sera 4.7.x.) La différence par rapport au Versionnage Sémantique est que la version correctif d'un package peut inclure non seulement des corrections de bugs mais aussi de nouvelles fonctionnalités d'API. (Cependant, la version correctif n'introduira pas de changements irréversibles.)
