Configurazione dell'estensione axe DevTools

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Free Trial
Not for use with personal data

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.

tip

Hai un server cloud DevTools privato? Scopri di più sulla configurazione dell'estensione axe DevTools per il cloud privato.

tip

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

Schermata iniziale dell'estensione con il menu "Opzioni" espanso

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

note

Per garantire agli utenti Pro risultati coerenti, axe DevTools ricorderà le loro impostazioni anche dopo la scadenza della sessione.

Aspetto

Screenshot delle impostazioni Aspetto nell'estensione del browser

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

Screenshot delle impostazioni Regole e Problemi nell'estensione del browser

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
tip

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)

Screenshot delle impostazioni di esportazione nell'estensione del browser

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)

Screenshot delle impostazioni avanzate nell'estensione del browser

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

Screenshot delle impostazioni del server nell'estensione del browser

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)

Screenshot delle impostazioni della modalità offline nell'estensione del browser

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).

tip

Si consiglia di utilizzare axe Configuration invece della configurazione dei criteri poiché offre maggiore flessibilità e richiede meno manutenzione.

note

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.

important

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
note

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: wcag22aaawcag22aawcag22awcag21aaawcag21aawcag21awcag2aaawcag2aawcag2aTTv5 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.