Verwendung der Axe Linter-Erweiterung für 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

Informationen zur Installation und Verwendung der Erweiterung mit VS Code

Free Trial
Not for use with personal data

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:

Zeigt ein fehlendes lang-Attribut im html-Element über einen Tooltip und einen Eintrag in der Probleme-Leiste am unteren Rand des VS-Code-Fensters

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:

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 .vsix von 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 .vsix stattdessen von Agora herunterladen.
tip

Benötigen Sie Hilfe mit Ihrem Agora-Konto?

Ü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

  1. Laden Sie das .vsix-Paket von einer der oben beschriebenen Quellen herunter.
  2. Öffnen Sie in VS Code das Erweiterungen-Panel.
  3. Klicken Sie auf das Überlaufmenü (...).
  4. Wähle Install from VSIX..., die letzte Option im Menü.
  5. Wählen Sie Ihre heruntergeladene .vsix-Datei aus.

Zeigt das Menüelement im Erweiterungen-Panel für das lokale Installieren von .vsix-Dateien

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:

  1. Öffnen Sie das Ausgabe-Panel (Anzeigen > Ausgabe).
  2. 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.