Verwendung der Axe Linter-Erweiterung für VS Code
Informationen zur Installation und Verwendung der Erweiterung mit VS Code
Die Axe DevTools Linter-Erweiterung für VS Code ermöglicht es Ihnen, Ihren Code direkt in VS Code und VS Code-kompatiblen Editoren, einschließlich KI-IDEs wie Cursor und Windsurf, auf Zugänglichkeitsprobleme zu überprüfen. Sie können React (JSX), React Native, Angular, Vue, HTML und Markdown auf häufige Zugänglichkeitsfehler überprüfen.
Erhalt der Erweiterung
In der Regel laden Sie die Erweiterung von der VS Code-Erweiterungsmarkt herunter. Klicken Sie auf die Schaltfläche Installieren, um die Erweiterung herunterzuladen und um Erlaubnis zu bitten, VS Code zu öffnen, um die Erweiterung zu installieren.
Wenn Sie VSCodium, eine KI-IDE wie Cursor oder Windsurf oder einen anderen mit VS Code kompatiblen Editor verwenden, können Sie die Erweiterung von der Open VSX-Registry installieren.
Siehe Installation in eingeschränkten Umgebungen für weitere Möglichkeiten, die Erweiterung herunterzuladen und zu installieren.
Übersicht über die Nutzung
Die Erweiterung hebt Barrierefreiheitsfehler in VS Code mit einer roten gewellten Linie hervor und bietet ein Tooltip, das den Fehler anzeigt. Darüber hinaus zeigt das Probleme-Fenster unten (falls aktiviert) eine Liste der Fehler an, wie unten gezeigt:
Das Tooltip und die Informationen im Probleme-Fenster enthalten einen Link zu Deque University für weitere Informationen über den angegebenen Barrierefreiheitsfehler. Im gezeigten Beispiel fehlt im Codebeispiel das lang-Attribut beim html-Element, das an der Deque University behandelt wird: html-hat-lang.
Konfiguration
Es ist nicht notwendig, die Erweiterung zu konfigurieren, aber Sie können ihr Verhalten durch Konfigurationsdateien ändern. Weitere Informationen finden Sie unter:
- Konfiguration des Axe DevTools Linters für eine Referenz zu den Konfigurationsoptionen von Axe DevTools Linter
- Linting benutzerdefinierter Komponenten mit dem Axe Accessibility Linter für VS Code oder JetBrains IDEs für Informationen zur Konfiguration der Erweiterung zur Prüfung benutzerdefinierter Komponenten
Unterstützung für Zugänglichkeitsregeln
Für weitere Informationen über die Regeln, die das Plugin verwendet, um Barrierefreiheitsfehler zu finden, siehe Zugänglichkeitsregeln.
Installation in eingeschränkten Umgebungen
In den meisten Fällen können Sie die Axe DevTools Linter-Erweiterung direkt vom VS Code Marketplace oder vom Open VSX-Registry installieren. Einige Organisationen haben jedoch Sicherheitsbeschränkungen, die die direkte Installation von Erweiterungen aus diesen Registern blockieren.
Das Erweiterungspaket ist eigenständig: Die Komponente, die Ihre Dateien überprüft, ist im Paket enthalten, sodass die Erweiterung beim ersten Start nichts herunterlädt. Das bedeutet, dass Sie es in einer eingeschränkten Umgebung von einer heruntergeladenen .vsix-Datei installieren können, indem Sie eine der folgenden Quellen verwenden:
- VS Code Marketplace oder Open VSX (empfohlen). Von einem Computer aus, der eines der Register erreichen kann, laden Sie die
.vsixvon der Seite der Erweiterung herunter (im Marketplace verwenden Sie den Erweiterung herunterladen-Link im Ressourcen-Abschnitt der Artikelseite), und übertragen Sie sie dann auf den eingeschränkten Computer. - Deques Agora-Software-Repository. Wenn Sie keines der Register erreichen können und eine Axe DevTools Linter-Lizenz haben, können Sie die
.vsixstattdessen von Agora herunterladen.
Benötigen Sie Hilfe mit Ihrem Agora-Konto?
- Kontaktieren Sie Ihren Deque-Vertreter
- Besuchen Sie die Support-Desk
- E-Mail an helpdesk@deque.com
Über das Installationspaket auf Agora
Deque stellt die Erweiterung im Agora-Software-Repository bereit:
| Erweiterungsname | Standort auf Agora | Beschreibung |
|---|---|---|
vscode-axe-linter-<version>.vsix |
https://agora.dequecloud.com/ui/native/linter-bin/vscode-linter/ | Das Erweiterungspaket, identisch mit der Version im VS Code Marketplace |
An dem oben genannten Ort sehen Sie einen Verzeichnisbetrachter, der alle verfügbaren Versionen auflistet. Wählen Sie die neueste Version aus und navigieren Sie durch die Unterverzeichnisse, bis Sie die .vsix-Datei finden.
Installationsschritte
- Laden Sie das
.vsix-Paket von einer der oben beschriebenen Quellen herunter. - Öffnen Sie in VS Code das Erweiterungen-Panel.
- Klicken Sie auf das Überlaufmenü (...).
- Wähle Install from VSIX..., die letzte Option im Menü.
- Wählen Sie Ihre heruntergeladene
.vsix-Datei aus.
Fehlerbehebung
Die VS Code-Erweiterung schreibt Diagnoseinformationen in einen Axe Linter Ausgabekanal. Dieses Protokoll erfasst die Startaktivität der Erweiterung, einschließlich Plattformdetails und Erweiterungsversion, und ist am nützlichsten zur Diagnose von Problemen, wenn die Erweiterung nicht korrekt startet oder initialisiert.
Um das Protokoll anzuzeigen:
- Öffnen Sie das Ausgabe-Panel (Anzeigen > Ausgabe).
- Wählen Sie Axe Linter aus dem Dropdown-Menü für Kanäle in der oberen rechten Ecke des Panels.
Wenn Sie Deque-Support wegen eines Erweiterungsproblems kontaktieren, kann die Bereitstellung des Inhalts dieses Protokolls helfen, das Problem zu diagnostizieren.
Nächste Schritte
Diese Dokumentationsseite enthält Informationen zur Verwendung der verschiedenen Angebote von Axe DevTools Linter. Für weitere Informationen siehe Über Axe DevTools Linter.


