WCAG-Regeln für Barrierefreiheit in C# validieren

Regeln für Web-Barrierefreiheit mit einer .NET-API auswählen

Aspose.HTML for .NET bietet ein AccessibilityRules -Repository mit Prinzipien, Richtlinien, Erfolgskriterien und Techniken aus WCAG 2.0. Wählen Sie die benötigten Regeln anhand ihrer Codes aus, erstellen Sie einen AccessibilityValidator und prüfen Sie eine HTML-Datei oder Webseite auf die entsprechenden Barrierefreiheitsprobleme.

Die Auswahl bestimmter Regeln ist sinnvoll, wenn ein Projekt einer festgelegten Barrierefreiheitsrichtlinie folgt oder nur eine Problemart geprüft werden soll. Der Validierungsbericht zeigt, welche Prüfungen fehlgeschlagen sind und welche HTML-Elemente beachtet werden müssen.

HTML anhand ausgewählter WCAG-Regeln prüfen

Das Beispiel wählt vier HTML-Techniken für Bildalternativen, Formularbeschriftungen, iframe-Titel und eindeutige Element-IDs aus. GetRules() gibt die passenden IRule-Objekte zurück, die anschließend an einen gezielten Validator übergeben werden.

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

string documentPath = Path.Combine("data", "input.html");
string[] ruleCodes = { "H37", "H44", "H64", "H93" };

WebAccessibility webAccessibility = new WebAccessibility();

// Retrieve only the requested accessibility rules
IList<IRule> selectedRules = webAccessibility.Rules.GetRules(ruleCodes);
AccessibilityValidator validator = webAccessibility.CreateValidator(
    selectedRules,
    ValidationBuilder.All);

// Validate the document against the selected rules
using HTMLDocument document = new HTMLDocument(documentPath);
ValidationResult validationResult = validator.Validate(document);

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

Bestimmte Barrierefreiheitsregeln validieren

1. Erstellen Sie ein WebAccessibility -Objekt und greifen Sie auf dessen Rules-Repository zu.
2. Legen Sie die Codes der Prinzipien, Richtlinien, Kriterien oder Techniken fest, die von der Validierungsrichtlinie des Projekts verlangt werden.
3. Übergeben Sie die Codes an GetRules() und prüfen Sie, ob jede angeforderte Regel zurückgegeben wurde.
4. Erstellen Sie aus der resultierenden IList<IRule> einen AccessibilityValidator .
5. Laden Sie das HTML mit HTMLDocument , rufen Sie Validate() auf und untersuchen oder speichern Sie den zurückgegebenen Bericht.

Hierarchie der Barrierefreiheitsregeln verstehen

• Prinzipien. Die WCAG-Kategorien der obersten Ebene beschreiben die grundlegenden Ziele barrierefreier Inhalte.
• Richtlinien. Jedes Prinzip enthält Richtlinien, die zusammengehörige Anforderungen an die Barrierefreiheit ordnen.
• Erfolgskriterien. Kriterien stellen prüfbare Anforderungen bereit und kennzeichnen die Konformitätsstufen A, AA oder AAA.
• Techniken und Fehler. Technikcodes wie H37 beschreiben Implementierungsprüfungen, während Fehlercodes Muster kennzeichnen, die ein Kriterium verletzen.
• Auswahl anhand von Codes. GetRules() akzeptiert einen oder mehrere Codes und lässt Codes aus, die im Repository nicht vorhanden sind.
• Gezielte Validierung. Ausgewählte Regeln unterstützen projektspezifische Prüfungen, eine begrenzte Regelliste ist jedoch kein vollständiges Barrierefreiheitsaudit.

Verwenden Sie den HTML Accessibility Validator , wenn die Anwendung eine umfassende oder gefilterte Prüfung statt einer expliziten Liste von Regelcodes benötigt.

Dokumentation und Referenz zu WCAG-Regeln

Die Dokumentation Regeln für die Barrierefreiheit im Web beschreibt die vollständige Repository-Hierarchie und zeigt Beispiele für GetPrinciple(), GetGuideline(), GetCriterion() und GetRules(). Der W3C-Index WCAG Techniques erläutert Zweck und Prüfverfahren einzelner Technik- und Fehlercodes.

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 zu Regeln für Web-Barrierefreiheit

1. Was ist der Unterschied zwischen einem WCAG-Kriterium und einer Technik?

Ein Erfolgskriterium ist eine prüfbare Anforderung zur Bestimmung der WCAG-Konformität. Eine Technik beschreibt einen dokumentierten Weg zur Erfüllung eines Kriteriums, während ein Fehler ein Muster bezeichnet, das dieses Kriterium nicht erfüllt. Das Bestehen einer einzelnen Technik belegt noch keine Konformität.

2. Wie validiere ich in C# nur bestimmte WCAG-Regeln?

Übergeben Sie die benötigten Codes an AccessibilityRules.GetRules(), erstellen Sie einen AccessibilityValidator mit der zurückgegebenen IList<IRule> und validieren Sie das HTMLDocument. Dadurch wird der Bericht auf die ausgewählten Regeln und anwendbaren Builder-Einstellungen begrenzt.

3. Kann GetRules() Prinzipien, Richtlinien, Kriterien und Techniken verarbeiten?

Ja. Jeder dieser Regeltypen implementiert IRule, sodass seine Codes an GetRules() übergeben werden können. Wählen Sie die Ebene passend zum gewünschten Umfang. Ein übergeordnetes Objekt umfasst eine breitere Gruppe, während ein Technikcode eine bestimmte Prüfung auswählt.

4. Was geschieht, wenn ein angeforderter Regelcode nicht gefunden wird?

Die Methode GetRules() lässt einen Code aus, der nicht im Repository enthalten ist. Vergleichen Sie die zurückgegebene Sammlung vor der Validierung mit den angeforderten Codes, damit ein Tippfehler oder nicht unterstützter Code den vorgesehenen Prüfumfang nicht unbemerkt verringert.

5. Belegt die Validierung ausgewählter Regeln die WCAG-Konformität?

Nein. Sie belegt nur, dass das Dokument anhand der ausgewählten automatischen Prüfungen bewertet wurde. Für die WCAG-Konformität müssen alle anwendbaren Erfolgskriterien bewertet werden, einschließlich der Anforderungen, die manuelle Tests und menschliche Beurteilung erfordern.