La configuration de l'extension de navigateur axe DevTools permet de contrôler des fonctionnalités telles que les versions axe-core, les normes de test, les ensembles de règles, la collecte de données d'utilisation, l'apprentissage automatique, les meilleures pratiques et bien plus encore. Cependant, pour la plupart des utilisateurs, les paramètres par défaut de l'extension axe DevTools fonctionneront parfaitement. Cette page explique comment configurer l'extension axe DevTools pour qu'elle fonctionne au sein de votre organisation.
Avez-vous un serveur DevTools sur un cloud privé ? En savoir plus sur la configuration de l'extension axe DevTools pour le cloud privé.
Vous souhaitez contrôler l’un de ces paramètres dans l’ensemble de votre organisation et même sur plusieurs produits Deque ? Découvrez [Configuration de l'axe DevTools] (https://docs.deque.com/devtools-server/4.0.0/en/axe-configuration) !
Configuration via la page des paramètres d'extension
Les utilisateurs peuvent accéder à la page des paramètres de l'extension en cliquant sur l'élément de menu « Options » (icône à trois points) dans la barre de menu supérieure et en cliquant sur l'élément de menu « Paramètres ».
Paramètres disponibles
Pour garantir aux utilisateurs Pro des résultats cohérents, axe DevTools mémorisera leurs paramètres même après l'expiration de leur session.
Apparence
Nom du réglage | Description | Valeurs |
---|---|---|
Langue | La langue à utiliser dans le texte d'extension. | Utiliser le navigateur par défaut (par défaut)AnglaisFrançaisJaponais |
Thème de mise en évidence | Le thème de surbrillance à utiliser lorsque des éléments sont mis en surbrillance | Contraste élevé (par défaut)Devtools |
Thème d'extension | Le thème de couleur pour l'interface utilisateur de l'extension. | Suivre les paramètres de mon navigateurSombreLumière |
Règles et questions
Nom du réglage | Description | Valeurs |
---|---|---|
Bonnes pratiques | Détermine si les règles de bonnes pratiques sont activées. Cela agit comme un filtre, ce qui signifie qu'il peut être activé sans avoir à réexécuter les tests pour afficher les problèmes de bonnes pratiques détectés. | ActiverDésactiver (par défaut) |
Sélectionnez la norme d'accessibilité | La norme d'accessibilité pour filtrer tous les problèmes par celle-ci. Notez que Trusted Tester v5 n'est pris en charge que dans les versions axe-core 4.7.1 et supérieures et que les problèmes IGT ne sont actuellement pas marqués avec les balises TTv5. | ToutWCAG 2.2 AAAWCAG 2.2 AAWCAG 2.2 AWCAG 2.1 AAAWCAG 2.1 AAWCAG 2.1 AWCAG 2.0 AAAWCAG 2.0 AAWCAG 2.0 ATrusted Tester v5 |
Règles expérimentales (plan Pro uniquement) | Détermine si les règles expérimentales sont activées. Ces règles ne sont pas exécutées lorsque les règles expérimentales sont désactivées, ce qui signifie que les tests doivent être réexécutés pour afficher les problèmes liés aux règles expérimentales. | ActiverDésactiver (par défaut) |
Sélectionnez la version axe-core (plan Pro uniquement) | La version axe-core à utiliser dans les analyses et les tests guidés intelligents. | le plus récentAinsi que les versions suivantes :Toutes les versions de patch d'axe-core dont la version mineure initiale date de moins de 6 moisLes 3 versions de patch précédentes d'axe-core seront toujours incluses en dehors de la politique ci-dessusToutes les versions mineures d'axe-core dont la sortie initiale date de moins de 15 mois |
Options 'Needs Review' (plan Pro uniquement) | Configure la manière dont les éléments 'Needs Review' sont traités. | Activer les problèmes nécessitant une révision et les inclure dans le total des problèmes automatiquesActiver l'examen des problèmes mais les exclure du total des problèmes automatiquesDésactiver entièrement la révision des besoins |
Comportement de l’outil Contraste des couleurs (plan Pro uniquement) | Comment fonctionne l'outil de contraste des couleurs (qui détermine automatiquement si les éléments de contraste des couleurs 'Needs Review' sont des problèmes ou non), le cas échéant. Pour que l'outil Contraste des couleurs puisse fonctionner, l'option « Options de révision des besoins » doit être activée. |
Certains paramètres comme « Sélectionner la norme d'accessibilité » et « Sélectionner la version axe-core » indiqueront d'où proviennent les valeurs par défaut spécifiques :
- "(Org Default)" : la valeur par défaut configurée de l'organisation de l'entreprise pour le paramètre donné (définie par l'administrateur dans axe Configuration)
- "(User Default)" : la valeur par défaut configurée par l'utilisateur actuel pour le paramètre donné (définie par l'utilisateur dans axe Configuration)
- "(Par défaut d'axe)" : la valeur par défaut de l'extension d'axe pour le paramètre donné
Besoin de révision, les meilleures pratiques et le niveau WCAG fonctionnent tous comme des filtres. Cela signifie que si vous modifiez l'un de ces paramètres, toutes les données et problèmes de test précédents seront mis à jour en conséquence sans avoir à réexécuter l'un de vos tests.
Export Settings (Pro plan only)
Nom du réglage | Description | Valeurs |
---|---|---|
Exporter le schéma | Le schéma d'exportation des éléments CSV. | Axe DevTools Pro (par défaut)axe DevTools Reporter |
Advanced Settings (Pro plan only)
Nom du réglage | Description | Valeurs |
---|---|---|
Activer les captures d'écran des problèmes partagés | Permet d'ajouter des captures d'écran aux problèmes partagés. | Activer (par défaut)Désactiver |
Activer l'apprentissage automatique | Certains IGT utilisent l’apprentissage automatique (IA) pour optimiser les tests. Cela prendra des captures d'écran et les enverra à nos serveurs IA pour être traitées. | Activer (par défaut)Désactiver |
Paramètres du serveur
Nom du réglage | Description | Valeurs |
---|---|---|
Utiliser les paramètres par défaut (serveur) | Utilisez les paramètres de serveur par défaut pour l'URL du serveur axe et les Données d'utilisation (voir ci-dessous). | Activé / coché (par défaut)Désactivé / décoché |
URL du serveur Axe | L'URL du serveur axe DevTools (portail de compte axe). Ne doit être modifié que si vous utilisez un serveur privé dans le cloud de Deque ou votre propre instance d'hébergement. | https://axe.deque.com (par défaut) |
Envoyer les données d'utilisation | Données d'analyse sur votre utilisation de l'application en plus des résultats de vos tests. | Activé / coché (par défaut)Désactivé / décoché |
URL du service d'utilisation | L'URL du serveur où les données d'utilisation sont envoyées. | https://usage.deque.com (par défaut) |
Organisation du service d'utilisation | Le nom de votre organisation à ajouter comme métadonnée à vos analyses d'utilisation. Si vous utilisez le service d'utilisation de Deque, consultez la section ci-dessous. | aucun(e) (défaut) |
Département du service d'utilisation | Le nom de votre département à ajouter comme métadonnée à vos analyses d'utilisation. Si vous utilisez le service d'utilisation de Deque, consultez la section ci-dessous. | aucun(e) (défaut) |
Application de service d'utilisation | Le nom de votre application à ajouter comme métadonnées à vos analyses d'utilisation. Si vous utilisez le service d'utilisation de Deque, consultez la section ci-dessous. | aucun(e) (défaut) |
Offline Mode (Enterprise feature)
Nom du réglage | Description | Valeurs |
---|---|---|
Activer le mode hors ligne | Activer ou non la Fonctionnalité Mode hors ligne. | Non coché (par défaut)coché |
Clé de licence hors ligne | Où saisir la clé de licence pour l'abonnement d'entreprise en mode hors ligne. |
Service d'utilisation/Organisation/Département/Application
Si vous utilisez le service de création de rapports d'utilisation de Deque, utilisez les éléments suivants :
- Organisation du Service d'Utilisation : obtenez un identifiant pour votre organisation auprès de votre contact Deque (chef de projet/représentant commercial)
- Département du Service d'Utilisation : décidez des valeurs uniques qui représenteront les différentes équipes/produits que vous souhaitez suivre avec le service d'utilisation. Ces valeurs doivent être utilisées comme valeurs de « Département » par différents groupes.
- Application du Service d'Utilisation : comme pour le service ci-dessus, vous pouvez utiliser le paramètre Application pour une représentation des données plus granulaire. Ce paramètre vous permet d'attacher un autre attribut à vos données d'utilisation.
Configuration via la politique d'extension
Chrome et Edge offrent aux administrateurs des moyens de configurer les environnements de leurs utilisateurs, en contrôlant avec précision les options d'extension installées et configurées. Pour chaque paramètre configuré via la politique, ce paramètre sera automatiquement appliqué et « verrouillé » (désactivé et impossible à modifier) pour tous vos utilisateurs. Pour tout paramètre non configuré par la politique, vos utilisateurs pourront modifier librement les valeurs.
En raison de la nature « hors ligne » de la fonctionnalité Mode hors ligne , les paramètres de configuration d'axe ne peuvent pas être récupérés. Par conséquent, la seule façon de contrôler les paramètres des utilisateurs en mode hors ligne dans votre organisation est d'utiliser la politique d'extension (décrite ci-dessous).
Il est recommandé d'utiliser axe Configuration au lieu de la configuration de stratégie car elle offre plus de flexibilité et nécessite moins de maintenance.
Si les paramètres sont définis à la fois dans axe Configuration et dans la politique, la valeur de Configuration Axe sera utilisée plutôt que la valeur de politique.
Si vous téléchargez l'extension axe DevTools pour Microsoft Edge depuis le Google Chrome Store, elle utilisera l'ID d'extension Chrome (lhdoppojpmngadmnindnejefpokejbdd). (Il est possible de télécharger des extensions Chrome à utiliser avec Microsoft Edge.) Sinon, si vous téléchargez l’extension depuis la boutique Microsoft Edge, l’ID de l’extension est kcenlimkmjjkdfcaleembgmldmnnlfkn comme indiqué dans la clé de registre Windows ci-dessous.
Configuration de la stratégie macOS
Créez un fichier configuration.plist avec les paramètres de stratégie souhaités (voir le tableau ci-dessous pour la répartition des propriétés spécifiques prises en charge) :
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>com.google.Chrome.extensions.lhdoppojpmngadmnindnejefpokejbdd</key>
<dict>
<key>AxeURL</key>
<dict>
<key>state</key>
<string>always</string>
<key>value</key>
<string>https://axe.biz</string>
</dict>
<key>UsageServiceURL</key>
<dict>
<key>state</key>
<string>always</string>
<key>value</key>
<string>https://usage.biz</string>
</dict>
<key>DataGather</key>
<dict>
<key>state</key>
<string>always</string>
<key>value</key>
<true />
</dict>
</dict>
</dict>
</plist>
Chargez ensuite le fichier plist en exécutant la commande suivante :
dscl -u YOUR_OS_ADMIN_USERNAME /Local/Default -mcximport /Computers/local_computer ./configuration.plist
Si la commande ci-dessus dscl
génère une erreur indiquant que le chemin n'est pas valide, vous pouvez créer un nœud pour la machine locale avec les commandes suivantes :
$ GUID=\`uuidgen\`
$ ETHER=ifconfig en0 | awk '/ether/ {print $2}'
$ dscl -u admin_username /Local/Default -create /Computers/local_computer
$ dscl -u admin_username /Local/Default -create /Computers/local_computer RealName "Local Computer"
$ dscl -u admin_username /Local/Default -create /Computers/local_computer GeneratedUID $GUID
$ dscl -u admin_username /Local/Default -create /Computers/local_computer ENetAddress $ETHER
Enfin, propagez les modifications en exécutant la commande suivante :
sudo mcxrefresh -n YOUR_OS_ADMIN_USERNAME
Configuration de la stratégie Windows
Sous Windows, les politiques sont mises en place en créant une entrée de registre.
Vous trouverez ci-dessous un exemple de ce à quoi devrait ressembler l'entrée de registre :
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\Software\Policies\Google\Chrome\3rdparty\extensions\lhdoppojpmngadmnindnejefpokejbdd\policy]
"PROPERTY_NAME"="PROPERTY_VALUE"
Où PROPERTY_NAME
est l'une des propriétés ci-dessous et PROPERTY_VALUE
est toute valeur valide pour la propriété (basée sur la colonne « Type » ci-dessous).
Si plusieurs propriétés doivent être déclarées, elles doivent être séparées par une nouvelle ligne.
Exemple complet avec plusieurs propriétés déclarées
[HKEY_LOCAL_MACHINE\Software\Policies\Google\Chrome\3rdparty\extensions\lhdoppojpmngadmnindnejefpokejbdd\policy]
"DataGather"="1"
"UsageServiceURL"=https://usage.deque.com"
"EnableAutomaticColorContrast"="1"
"WCAGLevel"="wcag21aa"
"IncludedNeedsReviewInIssueCount"="1"
"AutomaticColorContrastReview"="Manual"
Paramètres configurables disponibles via la stratégie
Nom de la propriété | Paramètre associé à axe DevTools | Type |
---|---|---|
AxeURL |
URL du serveur Axe | Texte |
DataGather |
Envoyer les données d'utilisation | Booléen (dans le registre Windows défini comme texte - « 1 » pour true , « 0 » pour false ) |
UsageServiceURL |
URL du service d'utilisation | Texte |
UsageServiceOrganization |
Organisation du service d'utilisation | Texte |
UsageServiceDepartment |
Département du service d'utilisation | Texte |
UsageServiceApplication |
Application de service d'utilisation | Texte |
EnableIssueScreenshots |
Captures d'écran des problèmes partagés | Booléen (dans le registre Windows défini comme texte - « 1 » pour true , « 0 » pour false ) |
EnableMachineLearning |
Apprentissage automatique | Booléen (dans le registre Windows défini comme texte - « 1 » pour true , « 0 » pour false ) |
EnableAutomaticColorContrast |
Comportement de l'outil de contraste des couleurs | Booléen (dans le registre Windows défini comme texte - « 1 » pour true , « 0 » pour false ) |
DisableAllScreenshots |
Il s'agit d'un paramètre de politique uniquement (non disponible dans la page des paramètres) qui désactive toutes les fonctionnalités qui prennent des captures d'écran persistantes. | Booléen (dans le registre Windows défini comme texte - « 1 » pour true , « 0 » pour false ) |
WCAGLevel (obsolète, utilisez plutôt AccessibilityStandard ) |
Sélectionnez le niveau WCAG (voir AccessibilityStandard pour les valeurs autorisées) |
Texte |
AccessibilityStandard |
Sélectionnez la norme d’accessibilité. Les valeurs disponibles sont : wcag22aaa wcag22aa wcag22a wcag21aaa wcag21aa wcag21a wcag2aaa wcag2aa wcag2a TTv5 |
Texte |
AxeVersion |
Sélectionnez la version d'axe-core (voir le tableau ci-dessus pour les valeurs autorisées) | Texte |
DisableIGT |
Il s'agit d'un paramètre de stratégie uniquement (non disponible dans la page des paramètres) qui désactive/masque tous les [French equivalent of IGTs]. | Booléen (dans le registre Windows défini comme texte - « 1 » pour true , « 0 » pour false ) |
IncludeNeedsReviewInIssueCount |
Inclure les problèmes nécessitant une révision dans les problèmes automatiques | Booléen (dans le registre Windows défini comme texte - « 1 » pour true , « 0 » pour false ) |
AutomaticColorContrastReview |
Comportement de l'outil de contraste des couleurs | Texte (peut être défini sur « automatique », ce qui équivaut à « Exécuter automatiquement après chaque analyse » ou « manuel », ce qui équivaut à « Choisir quand exécuter (recommandé) ».) |
DisableNeedsReview |
Options nécessitant une révision | Booléen (dans le registre Windows défini comme texte - « 1 » pour true , « 0 » pour false ) |
OfflineLicenseKey |
Activer le mode hors ligne / Clé de licence hors ligne | Texte |
Ressources additionnelles
Pour plus d'informations sur la manière de tirer parti des politiques de configuration des machines et des extensions de vos utilisateurs, veuillez vous référer à la documentation respective de Windows, Firefox et Chrome liée ci-dessous.
-
Windows : Pour distribuer ces modifications à vos utilisateurs, consultez Distribution des modifications du Registre documenté par Microsoft
-
Chrome : Configuration des applications et des extensions par stratégie
-
Firefox : Manifestes natifs - Manifeste