Validateur d’accessibilité HTML en C#

Valider l’accessibilité du HTML avec une API .NET

Aspose.HTML for .NET fournit un AccessibilityValidator pour vérifier les documents HTML selon les règles d’accessibilité WCAG. Validez un fichier local ou une page web, identifiez les contrôles ayant échoué et les éléments concernés, puis exportez les résultats sous forme de rapport.

Une validation régulière aide les équipes de développement à détecter les problèmes d’accessibilité avant la publication et à appliquer les mêmes contrôles chaque fois que le contenu HTML change.

Valider un document HTML en C#

Créez un validateur avec tous les paramètres de règles disponibles, validez le document et parcourez uniquement les résultats ayant échoué. Consultez ruleResult.Results afin de signaler chaque technique non validée, même si sa collection Errors distincte est vide.

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();
AccessibilityValidator validator = webAccessibility.CreateValidator(
    ValidationBuilder.All);

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

foreach (RuleValidationResult ruleResult in validationResult.Details)
{
    if (ruleResult.Success)
    {
        continue;
    }

    Console.WriteLine($"{ruleResult.Rule.Code}: {ruleResult.Rule.Description}");

    // Inspect every technique result, including entries without an error object
    foreach (ITechniqueResult techniqueResult in ruleResult.Results)
    {
        if (techniqueResult.Success)
        {
            continue;
        }

        Console.WriteLine(
            $"  {techniqueResult.Rule.Code}: {techniqueResult.Rule.Description}");

        IError error = techniqueResult.Error;
        if (error == null)
        {
            continue;
        }

        Console.WriteLine($"    {error.ErrorTypeName}: {error.ErrorMessage}");

        if (error.Target?.TargetType == TargetTypes.HTMLElement &&
            error.Target.Item is HTMLElement element)
        {
            Console.WriteLine($"    {element.OuterHTML}");
        }
    }
}

Comment valider l’accessibilité du HTML

1. Créez un objet WebAccessibility donnant accès à la création du validateur et au référentiel des règles d’accessibilité.
2. Appelez CreateValidator(ValidationBuilder.All) pour créer un validateur avec toutes les règles correspondant aux paramètres complets.
3. Chargez un fichier ou une URL dans un HTMLDocument .
4. Appelez Validate() et conservez l’objet ValidationResult renvoyé.
5. Parcourez Details, conservez les objets RuleValidationResult ayant échoué et examinez les techniques non validées dans Results. Affichez les détails de l’erreur et l’élément HTML concerné lorsqu’ils sont disponibles.

Configurer et traiter les contrôles d’accessibilité

• Validation complète. ValidationBuilder.All applique tous les paramètres disponibles de niveau et de technologie aux règles du référentiel.
• Validation filtrée. Le validateur peut être limité par niveau, technologie, balise HTML, principe, règle, critère ou liste de règles.
• Diagnostics détaillés. ValidationResult.Details fournit les résultats des règles, tandis que les erreurs des techniques indiquent les messages et les cibles concernées.
• HTML local et distant. HTMLDocument peut charger un fichier HTML ou l’URL d’une page web avant la validation.
• Résultats exportables. Les rapports peuvent être traités dans le code ou enregistrés au format texte, JSON ou XML pour les révisions et les processus automatisés.
• Vérification manuelle. Les résultats automatiques doivent être complétés par des tests du clavier, des technologies d’assistance, du contenu et de l’ergonomie.

Pour un contrôle ponctuel sans code, utilisez le vérificateur d’accessibilité web en ligne . Utilisez l’API .NET lorsque la validation doit être configurée, répétée ou intégrée à un processus de développement.

Documentation d’Accessibility Validator

Le guide Accessibility Validator – vérification selon les WCAG présente les surcharges disponibles de CreateValidator() et les filtres de ValidationBuilder. Consultez Erreurs et avertissements – vérification de l’accessibilité web pour traiter les techniques ayant échoué et les éléments concernés, ou Enregistrer les résultats de validation de l’accessibilité pour exporter les rapports au format texte, JSON ou XML.

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 le validateur d’accessibilité HTML

1. Comment valider l’accessibilité du HTML en C# ?

Chargez le fichier HTML ou l’URL avec HTMLDocument, créez un AccessibilityValidator à partir de WebAccessibility, puis appelez Validate(). L’objet ValidationResult renvoyé contient l’état et les résultats détaillés des règles évaluées.

2. Un validateur automatique peut-il garantir la conformité aux WCAG ?

Non. La validation automatique peut identifier les erreurs vérifiables par logiciel, mais de nombreuses exigences dépendent du contexte et du jugement humain. Des tests manuels au clavier et avec des technologies d’assistance, ainsi qu’un examen du sens du contenu, restent nécessaires.

3. Le validateur peut-il contrôler les fichiers HTML locaux et les pages web ?

Oui. HTMLDocument peut charger un fichier local ou une URL. La validation distante dépend de l’accès au réseau et de la capacité du document à récupérer les feuilles de style, les scripts et les autres ressources nécessaires aux contrôles sélectionnés.

4. Puis-je valider uniquement certaines règles ou certains niveaux WCAG ?

Oui. Utilisez ValidationBuilder pour filtrer par niveau ou technologie, ou créez le validateur avec un principe, une règle, un critère ou une liste explicite de règles. Cette approche convient lorsqu’un pipeline applique une politique ciblée plutôt que l’ensemble du référentiel.

5. Les résultats de validation de l’accessibilité peuvent-ils être enregistrés ?

Oui. Utilisez SaveToString() pour obtenir une représentation textuelle ou SaveTo() avec ValidationResultSaveFormat pour écrire du texte, du JSON ou du XML. La sortie structurée peut être archivée ou utilisée dans des rapports et des processus de contrôle qualité.