API für Web-Barrierefreiheit in C#

Web-Barrierefreiheit mit einer .NET-API prüfen

Aspose.HTML for .NET bietet APIs zur Prüfung der Barrierefreiheit von HTML-Dateien und Webseiten. Mit dem Namespace Aspose.Html.Accessibility können Sie eine vollständige Prüfung ausführen oder Regeln für bestimmte Probleme auswählen, etwa fehlende Alternativtexte für Bilder oder unzureichenden Farbkontrast.

Barrierefreies HTML erleichtert Menschen die Nutzung von Webinhalten, wenn sie Screenreader, Tastaturnavigation, Vergrößerung oder andere assistive Technologien verwenden. Regelmäßige Prüfungen helfen Entwicklungsteams, Probleme frühzeitig zu erkennen und WCAG-konforme Seiten auch bei Änderungen am Inhalt beizubehalten.

Workflow für die Web-Barrierefreiheit auswählen

HTML nach den WCAG-Stufen A und AA validieren

Dieses Beispiel wählt WCAG-Kriterien der Stufen A und AA aus und aktiviert Regeln für HTML- und CSS-Technologien. Anschließend wird das Dokument validiert und die erkannten Fehler und Warnungen werden exportiert.

using System;
using System.IO;
using Aspose.Html;
using Aspose.Html.Accessibility;
using Aspose.Html.Accessibility.Results;

string documentPath = Path.Combine("data", "input.html");

WebAccessibility webAccessibility = new WebAccessibility();

// Select WCAG Level A and AA checks for HTML and CSS technologies
ValidationBuilder validationPolicy = ValidationBuilder.None
    .UseHTML()
    .UseCSS()
    .UseLowestLevel()
    .UseMiddleLevel();

AccessibilityValidator validator = webAccessibility.CreateValidator(
    validationPolicy);

// Validate the document and export detected issues
using HTMLDocument document = new HTMLDocument(documentPath);
ValidationResult validationResult = validator.Validate(document);

Console.WriteLine($"Validation passed: {validationResult.Success}");

if (!validationResult.Success)
{
    Console.WriteLine(validationResult.SaveToString());
}

Workflow zur Barrierefreiheitsprüfung erstellen

1. Wählen Sie den Prüfumfang aus – alle verfügbaren Prüfungen, bestimmte Stufen und Technologien, ein Objekt aus der WCAG-Hierarchie oder eine explizite Regelliste.
2. Erstellen Sie ein WebAccessibility -Objekt und konfigurieren Sie einen AccessibilityValidator .
3. Laden Sie eine lokale Datei oder die URL einer Webseite in ein HTMLDocument .
4. Rufen Sie Validate() auf und verarbeiten Sie das zurückgegebene ValidationResult .
5. Erfassen Sie die automatischen Prüfergebnisse, korrigieren Sie den Quellinhalt und ergänzen Sie den Workflow durch die erforderlichen manuellen Barrierefreiheitstests.

Funktionen der API für Web-Barrierefreiheit

• Konfigurierbare Validierung. Verwenden Sie alle Regeln des Repositorys oder filtern Sie nach Konformitätsstufe, Technologie, HTML-Tag, Prinzip, Richtlinie, Kriterium oder Regelcode.
• Gezielte Prüfungen. Erstellen Sie Workflows für Alternativtexte, Beschriftungen, Dokumentstruktur, Farbkontrast und weitere unterstützte Anforderungen.
• Detaillierte Ergebnisse. Untersuchen Sie Ergebnisse von Regeln und Techniken, Fehlertypen, Meldungen sowie die betroffenen HTML- oder CSS-Ziele.
• Berichtsexport. Speichern Sie Validierungsergebnisse als TXT, JSON oder XML für Auswertungen, Protokolle und automatisierte Qualitätssicherung.
• Anwendungsintegration. Führen Sie dieselbe Richtlinie bei der Inhaltsverarbeitung, CMS-Validierung, in Tests oder CI/CD-Pipelines wiederholt aus.
• Definierter Umfang. Automatische Prüfungen unterstützen die Barrierefreiheitsbewertung, können jedoch keine vollständige WCAG-Konformität ohne manuelle Prüfung bestätigen.

Für eine einmalige Prüfung ohne eigenen Code verwenden Sie den Online Web Accessibility Checker .

Dokumentation zur Web-Barrierefreiheit

Beginnen Sie mit der Dokumentationsübersicht Web-Barrierefreiheit in C# prüfen . Unter Accessibility Validator – WCAG-Prüfung für Websites finden Sie die Konfiguration, Regeln für die Barrierefreiheit im Web erklärt die Hierarchie des Regel-Repositorys und Ergebnisse der Barrierefreiheitsprüfung speichern beschreibt die Berichtsformate.

Aspose.HTML for .NET installieren

Installieren Sie Aspose.HTML for .NET aus NuGet mit der .NET CLI:

dotnet add package Aspose.HTML

Alternativ können Sie die Benutzeroberfläche des NuGet-Paket-Managers verwenden oder Install-Package Aspose.HTML in der Paket-Manager-Konsole ausführen. Einzelheiten zur Einrichtung finden Sie in der Installationsanleitung . Mit einer temporären Lizenz können Sie die API ohne Einschränkungen der Evaluierung testen.

Häufige Fragen zur Web-Accessibility-API

1. Welche Barrierefreiheitsprüfungen kann Aspose.HTML for .NET automatisieren?

Die API kann HTML anhand unterstützter Regeln prüfen, darunter Regeln zu Alternativtexten, Beschriftungen, Struktur, CSS und Farbkontrast. Der genaue Umfang hängt von den ausgewählten Regeln, Technologien und Konformitätsstufen ab.

2. Sollte ich alle Regeln validieren oder nur eine kleinere Auswahl?

Verwenden Sie für eine allgemeine Bewertung die vollständige Validierung. Wählen Sie Stufen, Technologien, Tags, Kriterien oder einzelne Regelcodes aus, wenn das Projekt einer festgelegten Richtlinie folgt oder eine Komponente schneller geprüft werden soll. Eine eingeschränkte Regelliste ist kein vollständiges Audit.

3. Können Prüfungen der Web-Barrierefreiheit in CI/CD ausgeführt werden?

Ja. Führen Sie den Validator während Tests oder Inhalts-Builds aus, exportieren Sie die Ergebnisse und legen Sie projektspezifisch fest, wann die Pipeline warnen oder fehlschlagen soll. Manuelle Barrierefreiheitstests bleiben ein eigener Teil des Release-Prozesses.