Accessibility Validator – Vérification de l'accessibilité des sites web

Créer un validateur

Aspose.HTML for Java fournit le paquet com.aspose.html.accessibility, qui est destiné à toutes les manipulations et vérifications liées à l’accessibilité du web. La classe AccessibilityValidator initialise un objet utilisé pour valider le document en fonction des critères de réussite des WCAG. La classe n’a pas de constructeur interne, les utilisateurs ne peuvent donc pas créer directement un objet de la classe. Pour créer un objet, vous devez utiliser le conteneur WebAccessibility.

Pour créer un validateur, initialisez l’objet de la classe WebAccessibility comme suit :

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

L’objet webAccessibility possède plusieurs méthodes surchargées createValidator() pour créer une instance de AccessibilityValidator avec différents niveaux de personnalisation. Ces méthodes permettent de créer des validateurs en utilisant toutes les règles par défaut, une règle spécifique ou une liste de règles, et peuvent être personnalisées en utilisant un objet ValidationBuilder. Cette approche flexible permet de réaliser des contrôles d’accessibilité simples ou hautement personnalisés.

Les exemples Java suivants montrent comment initialiser un AccessibilityValidator pour toutes les règles disponibles ou pour un sous-ensemble spécifique basé sur un seul principe d’accessibilité :

Exemple 1. Créer un validateur pour vérifier toutes les règles

Cet exemple montre comment initialiser un AccessibilityValidator qui inclut toutes les règles d’accessibilité disponibles en utilisant les paramètres complets par défaut fournis par ValidationBuilder.getAll() :

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

// Create an accessibility validator with all rules using the default settings
AccessibilityValidator validator = webAccessibility.createValidator(ValidationBuilder.getAll());

Exemple 2. Créer un validateur pour un principe spécifique

Dans cet exemple, un principe d’accessibilité spécifique est sélectionné à l’aide de son code (par exemple, “1”) et un validateur est créé uniquement pour les règles relevant de ce principe :

// Retrieve a specific principle by its code
IRule rule = webAccessibility.getRules().getPrinciple("1");

// Create a validator for that principle using the same default settings
AccessibilityValidator validatorRule = webAccessibility.createValidator(rule, ValidationBuilder.getAll());

Classe ValidationBuilder

La classe ValidationBuilder définit une classe d’aide qui peut être utilisée pour personnaliser la liste des règles à vérifier par le validateur. La classe ValidationBuilder définit des méthodes et fournit des implémentations concrètes des étapes de configuration.

La classe ValidationBuilder offre trois ensembles de propriétés prédéfinies :

• All – permet tous les niveaux et toutes les technologies,
• Default – active uniquement les technologies générales au niveau le plus bas,
• None – aucun réglage n’est appliqué.

La classe fournit également des méthodes pour personnaliser la validation, comme la sélection de technologies spécifiques ( useHTML(), useCSS(), useScript()), la définition de niveaux de critères (useLowestLevel(), useMiddleLevel(), useHighestLevel(), allLevels()), etc.

Par exemple, le code Java suivant initialise AccessibilityValidator pour effectuer des contrôles d’accessibilité basés sur la configuration de l’utilisateur. Il commence par créer un conteneur WebAccessibility, qui sert de point d’accès principal aux fonctions de validation. Ensuite, en utilisant ValidationBuilder.getNone(), il crée un validateur sans règles prédéfinies. À partir de là, il active explicitement les contrôles pour les technologies HTML et CSS et limite la validation à un niveau de conformité moyen (généralement le niveau AA des WCAG). Cette configuration permet une validation ciblée, basée sur les normes, qui ne vise que les technologies sélectionnées et un niveau de conformité spécifique.

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

// Create a validator with no predefined filters, enabling HTML and CSS technologies, and selecting the middle conformance levels
AccessibilityValidator validatorHTML = webAccessibility.createValidator(
    ValidationBuilder.getNone()
                     .useHTML()
                     .useCSS()
                     .useMiddleLevel()
);

Classe ValidationResult

La classe ValidationResult est l’élément central de la validation de l’accessibilité du web. Elle encapsule les résultats des contrôles d’accessibilité, en fournissant un moyen structuré d’analyser, de gérer et d’agir sur les résultats des opérations de validation. Pour l’utiliser, instanciez un objet validateur et invoquez la méthode validate(document), en passant le document à valider. La méthode renvoie un objet ValidationResult contenant les résultats du processus de validation.

La classe ValidationResult regroupe les résultats de tous les critères définis dans l’objet AccessibilityRules, et sert de conteneur principal pour la présentation des résultats de la validation. Elle comprend deux propriétés clés :

• Details, qui fournit des résultats détaillés pour chaque critère vérifié ;
• Success, qui indique l’état général de la validation (réussite/échec).

Pour supporter l’exportation des résultats et les rapports, la classe fournit plusieurs méthodes : saveTo(TextWriter) et saveTo(TextWriter, ValidationResultSaveFormat) permettent d’enregistrer les résultats dans le flux de sortie spécifié, tandis que saveToString() renvoie les résultats de la validation sous la forme d’une String formatée.

Une description plus complète peut être trouvée dans l’article Résultats de validation – Vérifier l’accessibilité du Web en Java.

Valider un document HTML

Pour procéder à la validation des documents, suivez les étapes suivantes :

1. Utilisez le constructeur WebAccessibility() pour créer une instance de la classe WebAccessibility.
2. Appeler une des méthodes createValidator() pour créer un objet validator.
3. Charger un document HTML en utilisant l’un des constructeurs HTMLDocument().
4. Utilisez la méthode validate(document) pour valider le document en fonction des règles d’accessibilité du web.
5. Le résultat de la validation est une instance de la classe ValidationResult.
6. Imprimez les résultats de la validation sur la console et utilisez-les si nécessaire pour une analyse plus approfondie.

Voici un exemple d’appel à la validation d’un document. Le code Java suivant écrira dans la console quelles règles ont passé le test et lesquelles ne l’ont pas passé :

// Validate HTML against WCAG rules using Java

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

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

// Prepare a path to a source HTML file
String documentPath = "input.html";

// Initialize an object of the HTMLDocument class
final HTMLDocument document = new HTMLDocument(documentPath);
ValidationResult validationResult = validator.validate(document);

// Checking for success
if (!validationResult.getSuccess()) {
    // Get a list of RuleValidationResult Details
    for (RuleValidationResult detail : validationResult.getDetails()) {
        System.out.println(String.format("%s: %s = %s",
                detail.getRule().getCode(),
                detail.getRule().getDescription(),
                detail.getSuccess()));
    }
}

Voir aussi

• Vous trouverez des conseils utiles sur l’évaluation et l’amélioration de la visibilité du texte dans l’article Accessibilité du contraste des couleurs, qui couvre la vérification du contraste basée sur les WCAG à l’aide d’Aspose.HTML for Java.
• L’article Accessibilité aux lecteurs d’écran contient des instructions sur la manière de vérifier que le contenu web est compatible avec les lecteurs d’écran. Vous y apprendrez comment vérifier le texte alt et d’autres éléments clés.
• Si vous souhaitez savoir comment afficher les résultats de la validation et identifier les problèmes d’accessibilité du web, consultez l’article Résultats de la validation.
• Dans l’article Vérification de l’accessibilité du web – Erreurs et avertissements, vous apprendrez comment collecter par programmation en Java des informations sur les erreurs et les avertissements lors de la vérification de l’accessibilité d’un site web.
  

Aspose.HTML propose gratuitement en ligne Vérificateur d’accessibilité Web. Cet outil analyse les pages web, valide 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.