Utilizzo dell'estensione Axe Linter per VS Code
Informazioni sull'installazione e l'uso dell'estensione con VS Code
L'estensione Axe DevTools Linter per VS Code ti consente di verificare i problemi di accessibilità del tuo codice direttamente all'interno di VS Code e degli editor compatibili con VS Code, inclusi IDE AI come Cursor e Windsurf. Puoi controllare React (JSX), React Native, Angular, Vue, HTML e Markdown per i difetti comuni di accessibilità.
Ottenere l'estensione
In genere, scarichi l'estensione dal marketplace delle estensioni di VS Code. Fai clic sul pulsante Installa , che scaricherà l'estensione e poi chiederà il permesso di aprire VS Code per installarla.
Se utilizzi VSCodium, un IDE AI come Cursor o Windsurf, o un altro editor compatibile con VS Code, puoi installare l'estensione dal Open VSX Registry.
Consulta Installazione in ambienti con restrizioni per altre modalità di download e installazione dell'estensione.
Panoramica del suo utilizzo
L'estensione evidenzia gli errori di accessibilità in VS Code con una linea ondulata rossa e fornisce un tooltip che indica l'errore. Inoltre, il riquadro Problemi sotto (se abilitato) mostra un elenco di errori, come mostrato di seguito:
Il tooltip e le informazioni nel riquadro Problemi includono un link a Deque University attributo sull'elemento lang attribute on the html , che è discusso su Deque University: html-has-lang.
Configurazione
La configurazione dell'estensione non è necessaria, ma puoi modificarne il comportamento utilizzando file di configurazione. Per ulteriori informazioni, vedi:
- Configurare Axe DevTools Linter per un riferimento alle opzioni di configurazione di Axe DevTools Linter
- Linting dei componenti personalizzati con l'Axe Accessibility Linter per VS Code o IDE JetBrains per informazioni sulla configurazione dell'estensione per controllare i componenti personalizzati
Supporto delle regole di accessibilità
Per ulteriori informazioni sulle regole utilizzate dal plugin per individuare errori di accessibilità, vedi Regole di accessibilità.
Installazione in ambienti con restrizioni
Nella maggior parte dei casi, puoi installare l'Axe Accessibility Linter direttamente dal VS Code Marketplace. Tuttavia, alcune organizzazioni hanno restrizioni di sicurezza che influenzano il processo di installazione in due modi:
- Non puoi scaricare dal VS Code Marketplace.
- L'estensione, durante il primo avvio, non può scaricare il componente binario richiesto, il componente che esegue l'analisi del tuo codice e che è specifico per il sistema operativo.
Se la tua organizzazione ha queste restrizioni, avrai bisogno di una licenza Axe DevTools Linter per accedere al repository software di Agora di Deque. Potrai quindi scaricare un .vsix pacchetto per l'estensione.
Hai bisogno di aiuto con il tuo account Agora?
- Contatta il tuo rappresentante Deque
- Visita il servizio assistenza
- Email helpdesk@deque.com
Informazioni sui pacchetti di installazione su Agora
Deque fornisce due opzioni di pacchetto nel repository software Agora:
| Nome dell'estensione | Posizione su Agora | Descrizione |
|---|---|---|
vscode-axe-linter-<version>.vsix |
https://agora.dequecloud.com/ui/native/linter-bin/vscode-linter/ | Solo l'estensione standard (identica alla versione del VS Code Marketplace), che deve scaricare il componente binario per il tuo sistema operativo al primo avvio |
vscode-axe-linter-bundle-<version>.vsix |
https://agora.dequecloud.com/ui/native/linter-bin/vscode-linter-bundle/ | Un pacchetto completo che include sia l'estensione che i componenti binari per tutti i sistemi operativi |
Vedrai un visualizzatore di directory di tutte le versioni dell'estensione, ad esempio:
Di solito scegli la versione più recente e scendi nelle sottodirectory fino a individuare il .vsix file.
Passaggi di installazione
- Scarica il tuo
.vsixpacchetto preferito dal repository Deque Agora. - In VS Code, apri il pannello Estensioni .
- Fai clic sul menu a tendina (...).
- Seleziona Installa da VSIX..., l'ultima opzione del menu.
- Scegli il tuo
.vsixfile scaricato.
Risoluzione dei problemi
L'estensione VS Code scrive informazioni diagnostiche in un canale di uscita Axe Linter . Questo registro cattura l'attività di avvio dell'estensione, inclusi i dettagli della piattaforma, la versione dell'estensione e lo stato del download del componente binario, ed è molto utile per diagnosticare problemi quando l'estensione non si avvia o non si inizializza correttamente.
Per visualizzare il log:
- Apri il pannello Output (Visualizza > Output).
- Seleziona Axe Linter dal menu a tendina del canale nell'angolo in alto a destra del pannello.
Se contatti il supporto Deque per un problema con l'estensione, includere il contenuto di questo registro può aiutare il team a diagnosticare il problema.
Prossimi Passi
Questo sito di documentazione contiene informazioni sull’utilizzo delle diverse offerte di Axe DevTools Linter. Per ulteriori informazioni, vedi Informazioni su Axe DevTools Linter.