Valider les règles d’accessibilité WCAG en C#

Sélectionner des règles d’accessibilité web avec une API .NET

Aspose.HTML for .NET fournit un référentiel AccessibilityRules contenant les principes, règles, critères de succès et techniques des WCAG 2.0. Sélectionnez les règles nécessaires par leur code, créez un AccessibilityValidator et vérifiez un fichier HTML ou une page web afin de détecter les problèmes d’accessibilité associés.

La sélection de règles précises est utile lorsqu’un projet applique une politique d’accessibilité définie ou doit tester un type de problème particulier. Le rapport de validation indique les contrôles qui ont échoué et les éléments HTML à corriger.

Vérifier le HTML selon des règles WCAG sélectionnées

L’exemple sélectionne quatre techniques HTML concernant les alternatives aux images, les libellés de formulaires, les titres des iframe et les identifiants uniques des éléments. GetRules() renvoie les objets IRule correspondants, qui sont ensuite transmis à un validateur ciblé.

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());
}

Comment valider des règles d’accessibilité précises

1. Créez un objet WebAccessibility et accédez à son référentiel Rules.
2. Définissez les codes des principes, règles, critères ou techniques requis par la politique de validation du projet.
3. Transmettez les codes à GetRules() et vérifiez que chaque règle demandée a été renvoyée.
4. Créez un AccessibilityValidator à partir de l’objet IList<IRule> obtenu.
5. Chargez le HTML avec HTMLDocument , appelez Validate(), puis examinez ou enregistrez le rapport renvoyé.

Comprendre la hiérarchie des règles d’accessibilité

• Principes. Les catégories WCAG de niveau supérieur décrivent les objectifs généraux d’un contenu accessible.
• Règles. Chaque principe contient des règles qui organisent les exigences d’accessibilité associées.
• Critères de succès. Les critères définissent des exigences vérifiables et indiquent les niveaux de conformité A, AA ou AAA.
• Techniques et échecs. Les codes de techniques tels que H37 décrivent des contrôles de mise en œuvre, tandis que les codes d’échec signalent des modèles qui enfreignent un critère.
• Sélection par code. GetRules() accepte un ou plusieurs codes et ignore ceux qui ne figurent pas dans le référentiel.
• Validation ciblée. Les règles sélectionnées permettent des contrôles propres au projet, mais une liste restreinte ne constitue pas un audit d’accessibilité complet.

Utilisez le validateur d’accessibilité HTML lorsque l’application nécessite un contrôle étendu ou filtré par le générateur plutôt qu’une liste explicite de codes.

Documentation et référence des règles WCAG

Consultez Règles d’accessibilité du Web pour découvrir la hiérarchie complète du référentiel et des exemples de GetPrinciple(), GetGuideline(), GetCriterion() et GetRules(). L’index W3C des techniques WCAG décrit l’objectif et la procédure de test de chaque code de technique et d’échec.

Installer Aspose.HTML for .NET

Installez Aspose.HTML for .NET depuis NuGet avec l’interface CLI .NET :

dotnet add package Aspose.HTML

Vous pouvez également utiliser l’interface du gestionnaire de packages NuGet ou exécuter Install-Package Aspose.HTML dans la console du gestionnaire de packages. Consultez le guide d’installation pour la configuration, ou demandez une licence temporaire afin d’évaluer l’API sans limitations.

Questions fréquentes sur les règles d’accessibilité web

1. Quelle est la différence entre un critère WCAG et une technique ?

Un critère de succès est une exigence vérifiable utilisée pour déterminer la conformité aux WCAG. Une technique décrit une méthode documentée pour satisfaire un critère, tandis qu’un échec décrit une situation qui ne le respecte pas. La réussite d’une seule technique ne prouve pas la conformité.

2. Comment valider uniquement certaines règles WCAG en C# ?

Transmettez les codes requis à AccessibilityRules.GetRules(), créez un AccessibilityValidator avec l’objet IList<IRule> renvoyé et validez le HTMLDocument. Le rapport est ainsi limité aux règles sélectionnées et aux paramètres applicables du générateur.

3. La méthode GetRules() accepte-t-elle les principes, règles, critères et techniques ?

Oui. Chacun de ces types de règle implémente IRule. Leurs codes peuvent donc être transmis à GetRules(). Choisissez le niveau correspondant à l’étendue souhaitée. Un objet de niveau supérieur comprend un groupe plus large, tandis qu’un code de technique cible un contrôle précis.

4. Que se passe-t-il si le code d’une règle d’accessibilité est introuvable ?

La méthode GetRules() ignore tout code absent du référentiel. Comparez la collection renvoyée avec les codes demandés avant la validation afin qu’une faute de frappe ou un code non pris en charge ne réduise pas silencieusement l’étendue prévue.

5. La validation de règles sélectionnées prouve-t-elle la conformité aux WCAG ?

Non. Elle prouve uniquement que le document a été évalué selon les contrôles automatiques sélectionnés. La conformité aux WCAG exige l’évaluation des critères applicables, y compris ceux qui nécessitent des tests manuels et un jugement humain.