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

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:

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 den Axe Accessibility Linter direkt aus dem VS Code Marketplace installieren. Einige Organisationen haben jedoch Sicherheitsbeschränkungen, die den Installationsprozess auf zwei Arten beeinflussen:

Sie können nichts aus dem VS Code Marketplace herunterladen.
Während des ersten Laufs kann die Erweiterung ihre erforderliche Binärkomponente, die das Prüfen Ihrer Dateien durchführt und betriebssystemspezifisch ist, nicht herunterladen.

Wenn Ihr Unternehmen diese Einschränkungen hat, benötigen Sie eine Lizenz für Axe DevTools Linter, um auf das Agora-Software-Repository von Deque zuzugreifen. Anschließend können Sie ein .vsix-Paket für die Erweiterung herunterladen.

tip

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 die Installationspakete auf Agora

Deque bietet zwei Paketoptionen im Agora-Software-Repository an:

Erweiterungsname	Standort auf Agora	Beschreibung
`vscode-axe-linter-<version>.vsix`	https://agora.dequecloud.com/ui/native/linter-bin/vscode-linter/	Nur die Standarderweiterung (identisch mit der Version im VS Code Marketplace), die beim ersten Start die Binärkomponente für Ihr Betriebssystem herunterladen muss
`vscode-axe-linter-bundle-<version>.vsix`	https://agora.dequecloud.com/ui/native/linter-bin/vscode-linter-bundle/	Ein komplettes Paket, das sowohl die Erweiterung als auch die Binärkomponenten für alle Betriebssysteme enthält

Sie sehen einen Verzeichnisbetrachter mit allen Versionen der Erweiterung, zum Beispiel:

In der Regel wählen Sie die neueste Version und durchblättern die Unterverzeichnisse, bis Sie die .vsix-Datei finden.

Installationsschritte

Laden Sie Ihr bevorzugtes .vsix-Paket aus dem Deque Agora-Repository 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 Aktivitäten beim Starten der Erweiterung, einschließlich Plattformdetails, Erweiterungsversion und Status des Downloads der Binärkomponente, und ist sehr nützlich zur Diagnose von Problemen, wenn die Erweiterung nicht korrekt startet oder initialisiert wird.

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.