La configurazione dell'estensione del browser axe DevTools consente di controllare funzionalità quali versioni di axe-core, standard di test, set di regole, raccolta di dati di utilizzo, machine learning, best practice e altro ancora. Tuttavia, per la maggior parte degli utenti, le impostazioni predefinite dell'estensione axe DevTools funzioneranno perfettamente. Questa pagina spiega come configurare l'estensione axe DevTools affinché funzioni all'interno della tua organizzazione.
Hai un server cloud DevTools privato? Scopri di più sulla configurazione dell'estensione axe DevTools per il cloud privato.
Vuoi controllare una qualsiasi di queste impostazioni nell'intera organizzazione e persino in più prodotti Deque? Dai un'occhiata alla configurazione di axe!
Configurazione tramite la pagina delle impostazioni dell'estensione
Gli utenti possono accedere alla pagina delle impostazioni nell'estensione cliccando sulla voce di menu "Opzioni" (icona con tre puntini) nella barra dei menu in alto e cliccando sulla voce di menu "Impostazioni".
Impostazioni disponibili
Per garantire agli utenti Pro risultati coerenti, axe DevTools ricorderà le loro impostazioni anche dopo la scadenza della sessione.
Aspetto
Nome impostazione | Descrizione | Valori |
---|---|---|
Lingua | Lingua da utilizzare nel testo dell'estensione. | Usa il browser predefinitoIngleseFranceseGiapponese |
Evidenzia il tema | Il tema di evidenziazione da utilizzare quando gli elementi vengono evidenziati | Contrasto elevato (predefinito)Devtools |
Tema di estensione | Il tema colore per l'interfaccia utente dell'estensione. | Seguire le impostazioni del mio browserScuroChiaro |
Regole e problemi riscontrati
Nome impostazione | Descrizione | Valori |
---|---|---|
Migliori pratiche | Determina se sono abilitate le regole delle best practice. Funziona come un filtro, il che significa che può essere attivato o disattivato senza dover rieseguire i test per visualizzare eventuali problemi di best practice applicabili riscontrati. | AbilitaDisabilita (predefinito) |
Seleziona lo standard di accessibilità | Lo standard di accessibilità in base al quale filtrare tutti i problemi. Si noti che Trusted Tester v5 è supportato solo nelle versioni 4.7.1 e successive di axe-core e che i problemi IGT non sono attualmente contrassegnati con i tag TTv5. | TuttoWCAG 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.0Trusted Tester v5 |
Regole sperimentali (solo piano Pro) | Determina se le regole sperimentali sono abilitate. Queste regole non vengono eseguite quando le regole sperimentali sono disabilitate, il che significa che i test devono essere rieseguiti per visualizzare eventuali problemi applicabili alle regole sperimentali. | AbilitaDisabilita (predefinito) |
Seleziona la versione axe-core (solo piano Pro) | La versione axe-core da utilizzare nelle scansioni e nei test guidati intelligenti. | più recenteOltre alle seguenti versioni:Tutte le versioni patch di axe-core in cui il rilascio minore iniziale è stato rilasciato meno di 6 mesi faLe 3 versioni precedenti della patch di axe-core saranno sempre incluse indipendentemente dalla politica sopra menzionataTutte le versioni minori di axe-core in cui la versione minore iniziale è stata rilasciata meno di 15 mesi fa |
Opzioni da rivedere (solo piano Pro) | Configura il modo in cui vengono trattati gli elementi da rivedere. | Abilita i problemi che necessitano di revisione e includili nel totale dei problemi rilevati automaticamenteAbilita la revisione dei problemi ma escludili dal totale dei problemi automaticiDisattivare completamente la revisione delle esigenze |
Comportamento dello strumento Contrasto colore (solo piano Pro) | Come funziona lo strumento di contrasto colore (che determina automaticamente se gli elementi di contrasto colore "necessita di revisione" costituiscono un problema o meno). Per poter utilizzare lo strumento Contrasto colore, è necessario abilitare "Richiede opzioni di revisione". |
Alcune impostazioni come "Seleziona standard di accessibilità" e "Seleziona versione di axe-core" indicheranno da dove provengono specifici valori predefiniti:
- "(Org Default)": valore predefinito configurato dall'organizzazione aziendale per l'impostazione specificata (impostato dall'amministratore in axe Configuration)
- "(Default utente)": valore predefinito configurato dall'utente corrente per l'impostazione specificata (impostato dall'utente in axe Configuration)
- "(axe Default)": il valore predefinito dell'estensione axe per l'impostazione specificata
La revisione delle esigenze, le best practice e il livello WCAG funzionano tutti come filtri. Ciò significa che se si modifica una qualsiasi di queste impostazioni, tutti i dati e i problemi dei test precedenti verranno aggiornati di conseguenza, senza dover rieseguire nessuno dei test.
Export Settings (Pro plan only)
Nome impostazione | Descrizione | Valori |
---|---|---|
Esporta schema | Schema di esportazione dei problemi in CSV | axe DevTools Pro (predefinito)axe DevTools Reporter |
Advanced Settings (Pro plan only)
Nome impostazione | Descrizione | Valori |
---|---|---|
Abilita screenshot di issue condivisi | Consente di aggiungere screenshot ai problemi condivisi. | Abilita (predefinito)Disabilita |
Abilita l'apprendimento automatico | Alcuni IGT utilizzano il Machine Learning (ML) per ottimizzare i test. Verranno acquisiti degli screenshot e inviati ai nostri server ML per l'elaborazione. | Abilita (predefinito)Disabilita |
Impostazioni del server
Nome impostazione | Descrizione | Valori |
---|---|---|
Utilizza le impostazioni predefinite (server) | Utilizzare le impostazioni predefinite del server per l'URL del server axe e i dati di utilizzo (vedere di seguito). | acceso / selezionato (predefinito)spento / non selezionato |
URL del server axe | URL per il server axe DevTools (Portale Account axe). È necessario apportare modifiche solo se si utilizza un server privato nel cloud di Deque o nella propria istanza di hosting. | https://axe.deque.com (predefinito) |
Invia dati di utilizzo | Dati analitici sul tuo utilizzo dell'applicazione, oltre ai risultati dei tuoi test. | acceso / selezionato (predefinito)spento / non selezionato |
URL del servizio di utilizzo | URL del server a cui vengono inviati i dati di utilizzo. | https://usage.deque.com (predefinito) |
Organizzazione del Servizio di Utilizzo | Il nome della tua organizzazione da aggiungere come metadati alle analisi di utilizzo. Se si utilizza il servizio di utilizzo di Deque, vedere la sezione seguente. | nessuno (predefinito) |
Dipartimento del Servizio di Utilizzo | Il nome del tuo reparto da aggiungere come metadati alle analisi di utilizzo. Se si utilizza il servizio di utilizzo di Deque, vedere la sezione seguente. | nessuno (predefinito) |
Applicazione del servizio di uso | Il nome della tua applicazione da aggiungere come metadati alle analisi di utilizzo. Se si utilizza il servizio di utilizzo di Deque, vedere la sezione seguente. | nessuno (predefinito) |
Offline Mode (Enterprise feature)
Nome impostazione | Descrizione | Valori |
---|---|---|
Abilita modalità offline | Se abilitare o meno la funzione Modalità offline. | non spuntato (predefinito)spuntato |
Chiave di licenza offline | Dove inserire la chiave di licenza per l'abbonamento aziendale alla modalità offline. |
di utilizzo del servizio Organizzazione/Dipartimento/Applicazione
Se si utilizza il servizio di reporting di Deque per l'utilizzo, utilizzare quanto segue:
- Usage Service Organization: Ottieni un identificatore per la tua organizzazione dal tuo contatto Deque (project manager/rappresentante commerciale)
- Usage Service Department: Decidi i valori univoci che rappresenteranno i diversi team/prodotti che desideri monitorare con il servizio di utilizzo. Questi valori dovrebbero essere utilizzati come valori "Dipartimento" da vari gruppi.
- Usage Service Application: analogamente al Dipartimento sopra, è possibile utilizzare l'impostazione Applicazione per una rappresentazione dei dati più granulare. Questa impostazione consente di associare un altro attributo ai dati di utilizzo.
Configurazione tramite criterio di estensione
Chrome ed Edge offrono agli amministratori la possibilità di configurare gli ambienti dei propri utenti, controllando con precisione le opzioni delle estensioni installate e configurate. Per ogni impostazione configurata tramite criterio, questa impostazione verrà automaticamente applicata e "bloccata" (disabilitata e non modificabile) per tutti gli utenti. Per qualsiasi impostazione non configurata tramite policy, gli utenti potranno modificare liberamente i valori.
A causa della natura "offline" della funzionalità Modalità offline , le impostazioni di configurazione di axe non possono essere importate. Di conseguenza, l'unico modo per controllare le impostazioni per gli utenti in modalità offline nell'intera organizzazione è tramite i criteri di estensione (descritti di seguito).
Si consiglia di utilizzare axe Configuration invece della configurazione dei criteri poiché offre maggiore flessibilità e richiede meno manutenzione.
Se le impostazioni sono definite sia in axe Configuration che nei criteri, il valore di axe Configuration verrà utilizzato a favore del valore dei criteri.
Se scarichi l'estensione axe DevTools per Microsoft Edge dal Google Chrome Store, verrà utilizzato l'ID dell'estensione di Chrome (lhdoppojpmngadmnindnejefpokejbdd). (È possibile scaricare le estensioni di Chrome da utilizzare con Microsoft Edge.) In caso contrario, se scarichi l'estensione dallo store di Microsoft Edge, l'ID dell'estensione è kcenlimkmjjkdfcaleembgmldmnnlfkn come mostrato nella chiave del Registro di sistema di Windows riportata di seguito.
Configurazione dei criteri MacOS
Create un file configuration.plist con le impostazioni di policy desiderate (vedere la tabella seguente per una ripartizione delle proprietà specifiche supportate):
<!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>
Quindi caricate il file plist eseguendo il seguente comando:
dscl -u YOUR_OS_ADMIN_USERNAME /Local/Default -mcximport /Computers/local_computer ./configuration.plist
Se il comando precedente dscl
generano un errore che indica che il percorso non è valido, è possibile creare un nodo per la macchina locale con i seguenti comandi:
$ 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
Infine, propagate le modifiche eseguendo il seguente comando:
sudo mcxrefresh -n YOUR_OS_ADMIN_USERNAME
Configurazione dei criteri di Windows
In Windows, le politiche vengono messe in atto creando una voce del registro.
Di seguito è riportato un esempio di come dovrebbe apparire la voce del registro:
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\Software\Policies\Google\Chrome\3rdparty\extensions\lhdoppojpmngadmnindnejefpokejbdd\policy]
"PROPERTY_NAME"="PROPERTY_VALUE"
Dove PROPERTY_NAME
è una delle proprietà sottostanti e PROPERTY_VALUE
è un qualsiasi valore valido per la proprietà (in base alla colonna "Tipo" sottostante).
Se devono essere dichiarate più proprietà, dovrebbero essere separate con una nuova riga.
Esempio completo con più proprietà dichiarate
[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"
Impostazioni configurabili disponibili tramite criteri
Nome della proprietà | Impostazione associata di axe DevTools | Tipo |
---|---|---|
AxeURL |
URL del server axe | Testo |
DataGather |
Invia dati di utilizzo | Booleano (nel registro di Windows impostato come testo - "1" per true , "0" per false ) |
UsageServiceURL |
URL del servizio di utilizzo | Testo |
UsageServiceOrganization |
Organizzazione del Servizio di Utilizzo | Testo |
UsageServiceDepartment |
Dipartimento del Servizio di Utilizzo | Testo |
UsageServiceApplication |
Applicazione del servizio di uso | Testo |
EnableIssueScreenshots |
Screenshot dei problemi condivisi | Booleano (nel registro di Windows impostato come testo - "1" per true , "0" per false ) |
EnableMachineLearning |
Apprendimento automatico | Booleano (nel registro di Windows impostato come testo - "1" per true , "0" per false ) |
EnableAutomaticColorContrast |
Comportamento dello strumento Contrasto colore | Booleano (nel registro di Windows impostato come testo - "1" per true , "0" per false ) |
DisableAllScreenshots |
Questa è un'impostazione di tipo policy (non disponibile nella pagina delle impostazioni) che disabilita tutte le funzionalità che acquisiscono screenshot persistenti. | Booleano (nel registro di Windows impostato come testo - "1" per true , "0" per false ) |
WCAGLevel (obsoleto, utilizzare AccessibilityStandard al suo posto) |
Selezionare il livello WCAG (vedere AccessibilityStandard per i valori consentiti) |
Testo |
AccessibilityStandard |
Selezionare Standard di accessibilità. I valori disponibili sono: wcag22aaa wcag22aa wcag22a wcag21aaa wcag21aa wcag21a wcag2aaa wcag2aa wcag2a TTv5 |
Testo |
AxeVersion |
Selezionare la versione di axe-core (vedere la tabella sopra per i valori consentiti) | Testo |
DisableIGT |
Questa è un'impostazione di tipo policy (non disponibile nella pagina delle impostazioni) che disabilita/nasconde tutti gli [Translation of IGTs]. | Booleano (nel registro di Windows impostato come testo - "1" per true , "0" per false ) |
IncludeNeedsReviewInIssueCount |
Includere i problemi che necessitano di revisione nei problemi automatici | Booleano (nel registro di Windows impostato come testo - "1" per true , "0" per false ) |
AutomaticColorContrastReview |
Comportamento dello strumento Contrasto colore | Testo (può essere impostato su "automatico", che equivale a "Esegui automaticamente dopo ogni scansione" o "manuale", che equivale a "Scegli quando eseguire (consigliato)".) |
DisableNeedsReview |
Opzioni da rivedere | Booleano (nel registro di Windows impostato come testo - "1" per true , "0" per false ) |
OfflineLicenseKey |
Abilita modalità offline/chiave di licenza offline | Testo |
Risorse aggiuntive
Per maggiori informazioni su come sfruttare i criteri per la configurazione dei computer e delle estensioni dei tuoi utenti, consulta la documentazione relativa a Windows, Firefox e Chrome collegata di seguito.
-
Windows: per distribuire queste modifiche agli utenti, vedere Distribuzione delle modifiche del Registro di sistema documentato da Microsoft
-
Firefox: Manifesti nativi - Manifest