Résultats de la validation – Vérifier l'accessibilité du Web à l'aide d'Aspose.HTML

Aspose.HTML for .NET fournit l’espace de noms Aspose.Html.Accessibility, qui est destiné à toutes les manipulations et vérifications liées à l’accessibilité du Web. Dans cet article, vous apprendrez à examiner les résultats des vérifications de l’accessibilité du web par rapport à la conformité aux WCAG, à signaler les critères testés et à détailler les problèmes spécifiques rencontrés au cours de la validation.

L’article Accessibility Validator vous explique comment vérifier par programme l’accessibilité d’un site web.

Classe ValidationResult

L’espace de noms Aspose.Html.Accessibility.Results contient des classes décrivant les résultats de la validation des règles. La classe ValidationResult est la classe principale qui contient les résultats pour tous les critères. L’objet ValidationResult comprend une description des résultats de la vérification d’un document et possède des propriétés :

Property	Description
Success	Returns a boolean that says whether the validation succeeded.
Details	Returns IList< RuleValidationResult> containing objects of RuleValidationResult with information about validation results.
SaveToString()	Save validation results to string
SaveTo(TextWriter writer)	Saves the validation results in a System.IO.TextWriter object in text format.
SaveTo(TextWriter writer, ValidationResultSaveFormat format)	Saves the validation results to the System.IO.TextWriter object, where the ValidationResultSaveFormat type parameter specifies in what format the text will be saved.

Voici un extrait de code C# pour un contrôle de l’accessibilité du web. Il configure un validateur avec des paramètres spécifiques, valide un document HTML et affiche les résultats de la validation dans la console :

// Validate HTML against WCAG rules using C#

// Initialize a webAccessibility container
WebAccessibility webAccessibility = new WebAccessibility();

// Create an accessibillity validator with static instance for all rules from repository that match the builder settings
AccessibilityValidator validator = webAccessibility.CreateValidator(ValidationBuilder.All);

// Prepare a path to a source HTML file
string documentPath = Path.Combine(DataDir, "input.html");

// Initialize an object of the HTMLDocument class
using (HTMLDocument document = new HTMLDocument(documentPath))
{
    // Check the document
    ValidationResult validationResult = validator.Validate(document);

    // Checking for success
    if (!validationResult.Success)
    {
        // Get a list of RuleValidationResult Details
        foreach (RuleValidationResult detail in validationResult.Details)
        {
            Console.WriteLine("{0}:{1} = {2}", detail.Rule.Code, detail.Rule.Description, detail.Success);
        }
    }
}

Le code fournit des informations sur les problèmes d’accessibilité à la console, ce qui vous permet d’identifier et de résoudre les problèmes spécifiques dans votre document HTML.

Classe RuleValidationResult

La classe RuleValidationResult – résultat de la vérification de la règle – contient une liste de résultats de méthodes ITechniqueResult, qui permettent de satisfaire aux critères de réussite.

Property	Description
Success	Returns a boolean that says whether the validation succeeded.
Rule	Returns the checked rule. The rule has a type that implements the IRule interface.
Results	Returns a collection of all results, both successful and not. Returns type is IList< ITechniqueResult>.
Errors	Returns a collection of results with Errors. Returns type is IList< ITechniqueResult>.
Warnings	Returns a collection of results with Warnings. Returns type is IList< ITechniqueResult>.

Le code suivant parcourt la liste des objets RuleValidationResult dans la propriété Details d’un objet validationResult. Chaque RuleValidationResult représente le résultat de la vérification d’une règle d’accessibilité spécifique au cours du processus de validation :

    // Get a list of RuleValidationResult Details
    foreach (RuleValidationResult result in validationResult.Details)
    {
        Console.WriteLine("{0}:{1} = {2}", result.Rule.Code, result.Rule.Description, result.Success);
    }

Assume the Details contains results for two rules – H37 and H67. The output will be:

H37:Check alt attributes for images = True
H67:Check that all forms have labels = False

ITechniqueResult

L’interface ITechniqueResult est une interface publique qui contient des informations sur le résultat de la validation.

Property	Description
Success	Returns a boolean that says whether the validation succeeded.
Rule	Returns the checked technique with type of IRule.
Error	Returns the object with error. Returns type is IError.

Voici un exemple en C# de la sortie des résultats qui n’ont pas passé le test des critères de réussite. Nous imprimons sur la console le code de description des critères, ainsi que tous les détails de l’exécution des méthodes de ces critères aussi bien avec succès qu’avec des erreurs :

1. Chaque RuleValidationResult représente un critère d’accessibilité spécifique évalué lors de la validation. Le code itère à travers les objets RuleValidationResult contenus dans validationResult.Details.
2. Vérifier si le critère a échoué – !criterionResult.Success. Si le critère échoue, le code signale des informations sur le critère qui n’a pas abouti.
3. Utilisez Console.WriteLine pour imprimer le code et la description du critère défaillant.
4. Ensuite, il parcourt les objets ITechniqueResult. Ces objets ITechniqueResult représentent les résultats des règles individuelles du critère qui ont signalé des erreurs.
5. Pour chaque résultat de règle, créez un objet StringBuilder pour formater les informations sur la méthode, y compris le code de la méthode, le succès de la méthode et la description de la méthode.
6. Imprimer des informations sur le résultat de chaque règle, y compris le code de la méthode, l’état de réussite et la description.

// Validate HTML accessibility using C# and print all failed WCAG rule with their descriptions

// Initialize a webAccessibility container
WebAccessibility webAccessibility = new WebAccessibility();

// Create an accessibillity validator with static instance for all rules from repository that match the builder settings
AccessibilityValidator validator = webAccessibility.CreateValidator(ValidationBuilder.All);

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

// Initialize an object of the HTMLDocument class
using (HTMLDocument document = new HTMLDocument(documentPath))
{
    // Check the document
    ValidationResult validationResult = validator.Validate(document);

    // Take a list of rules results
    foreach (RuleValidationResult ruleResult in validationResult.Details)
    {
        // List only unsuccessful rule
        if (!ruleResult.Success)
        {
            // Print the code and description of the rule
            Console.WriteLine("{0}:{1}", ruleResult.Rule.Code, ruleResult.Rule.Description);

            // Print the results of all methods
            foreach (ITechniqueResult ruleDetail in ruleResult.Results)
            {
                // Print the code and description of the criterions
                StringBuilder str = new StringBuilder(string.Format("\n{0}: {1} - {2}",
                    ruleDetail.Rule.Code, ruleDetail.Success,
                    ruleDetail.Rule.Description));
                Console.WriteLine(str.ToString());
            }
        }
    }
}

L’utilisation d’Aspose.HTML for .NET vous permet d’examiner systématiquement les résultats des contrôles d’accessibilité du web, de signaler les critères testés et de détailler les problèmes spécifiques rencontrés au cours du processus de validation. Cela permet de comprendre la nature des problèmes d’accessibilité de votre contenu web et de prendre les mesures appropriées pour les résoudre.

Voir aussi

• Dans le chapitre Vérification de l’accessibilité du Web, vous apprendrez à vérifier l’accessibilité d’un site Web pour qu’il soit conforme aux WCAG ou qu’il réponde uniquement à des critères spécifiques en utilisant les classes et les méthodes des espaces de noms Aspose.Html.Accessibility et Aspose.Html.Accessibility.Results.
• Consultez l’article Vérifier le contraste des couleurs en C# si vous souhaitez apprendre à ajuster correctement le contraste de votre contenu web conformément aux normes WCAG, l’autorité mondiale en matière d’accessibilité du web. Vous découvrirez comment tester l’accessibilité du contraste des couleurs à l’aide de C# et rendre votre contenu web facile à lire pour tous les utilisateurs.
• Dans l’article Accessibility Validator, vous découvrirez la classe AccessibilityValidator qui peut être utilisée pour tester les règles d’accessibilité du web telles que les principes, les lignes directrices et les critères.
• Dans l’article Règles d’accessibilité du web, vous apprendrez à utiliser la classe AccessibilityRules, qui est un référentiel d’exigences, de critères de réussite et de techniques WCAG 2, pour les contrôles d’accessibilité du web.
• L’article Erreurs et avertissements traite des classes et des interfaces qui permettent de collecter des informations sur les erreurs et les avertissements lors des tests d’accessibilité des sites web. Il se concentre sur les critères d’échec et les méthodes qui signalent les erreurs, et fournit un exemple en C# pour récupérer les erreurs d’accessibilité du web après avoir testé un document HTML.
  

Aspose.HTML propose gratuitement en ligne Vérificateur d’accessibilité Web. Cet outil analyse les pages web, vérifie leur conformité aux WCAG, identifie les problèmes et suggère des améliorations. Il vous permet de déterminer l’ampleur des corrections nécessaires et l’écart entre l’état actuel de votre site web ou de votre document HTML et les exigences des WCAG.