Utilizzo dell'estensione Axe Linter per VS Code

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

Informazioni sull'installazione e l'uso dell'estensione con VS Code

Not for use with personal data

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

Tipicamente, si scarica l'estensione da marketplace delle estensioni di VS Code. Fare clic sul pulsante Installa, che scaricherà l'estensione e poi chiederà il permesso di aprire VS Code per installarla.

Se si utilizza VSCodium, un IDE AI come Cursor o Windsurf, o un altro editor compatibile con VS Code, è possibile installare l'estensione da Open VSX Registry.

Vedi Installazione in ambienti con restrizioni per altri modi di scaricare e installare l'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 pannello Problemi in basso (se abilitato) visualizza un elenco di errori, come mostrato di seguito:

Il tooltip e le informazioni nel pannello Problemi includono un link a Deque University per ulteriori informazioni sull'errore di accessibilità specificato. Nell'esempio mostrato, al codice manca l'attributo lang sull'elemento html, discusso presso 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 su come configurare l'estensione per l'analisi dei componenti personalizzati

Supporto delle regole di accessibilità

Per maggiori informazioni sulle regole che il plugin utilizza per individuare gli errori di accessibilità, vedere Regole di accessibilità.

Installazione in ambienti con restrizioni

Nella maggior parte dei casi, puoi installare l'estensione Axe DevTools Linter direttamente dal Mercato delle estensioni di VS Code o dall'Open VSX Registry. Alcune organizzazioni, tuttavia, hanno restrizioni di sicurezza che impediscono l'installazione delle estensioni direttamente da questi registri.

Il pacchetto dell'estensione è completo: il componente che analizza i tuoi file è incluso nel pacchetto, quindi l'estensione non scarica nulla al primo avvio. Ciò significa che può essere installata in un ambiente con restrizioni da un file .vsix scaricato, utilizzando una delle seguenti fonti:

Mercato di VS Code oppure Open VSX (consigliato). Da una macchina che può accedere a entrambi i registri, scarica il .vsix dalla pagina dell'estensione (sul Mercato, utilizza il link Scaricare l'estensione nella sezione Risorse della pagina dell'elemento), quindi trasferiscilo alla macchina con restrizioni.
Repository software Agora di Deque. Se non puoi accedere a entrambi i registri e hai una licenza Axe DevTools Linter, puoi invece scaricare il .vsix da Agora.

tip

Hai bisogno di aiuto con il tuo account Agora?

Contatta il tuo rappresentante Deque
Visita servizio assistenza
Email helpdesk@deque.com

Informazioni sul pacchetto di installazione su Agora

Deque fornisce l'estensione sul 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/	Il pacchetto dell'estensione, identico alla versione del Mercato delle estensioni di VS Code

Nel luogo sopra indicato, vedrai un visualizzatore di directory che elenca tutte le versioni disponibili. Scegli l'ultima versione e entra nelle sottodirectory finché non trovi il file .vsix.

Passaggi di installazione

Scarica il pacchetto .vsix da una delle fonti descritte sopra.
In VS Code, apri il pannello Estensioni.
Fai clic sul menu di overflow (...).
Seleziona Installa da VSIX..., l'ultima opzione del menu.
Scegli il file .vsix che hai scaricato.

Risoluzione dei problemi

L'estensione di VS Code scrive informazioni di diagnostica su un canale di Output Axe Linter. Questo log cattura l'attività di avvio dell'estensione, comprese le informazioni sulla piattaforma e la versione dell'estensione, ed è particolarmente utile per diagnosticare problemi quando l'estensione non riesce ad avviarsi o inizializzarsi correttamente.

Per visualizzare il log:

Apri il pannello Output (Visualizza > Output).
Seleziona Axe Linter dal menu a discesa del canale nell'angolo in alto a destra del pannello.

Se contatti Deque per un problema con l'estensione, includere il contenuto di questo log può aiutare il team a diagnosticare il problema.

Prossimi Passi

Questo sito di documentazione contiene informazioni sull'uso delle diverse offerte di Axe DevTools Linter. Per ulteriori informazioni, vedere Informazioni su Axe DevTools Linter.