API d’accessibilité web pour C#

Vérifier l’accessibilité web avec une API .NET

Aspose.HTML for .NET fournit des API permettant de vérifier l’accessibilité des fichiers HTML et des pages web. Utilisez l’espace de noms Aspose.Html.Accessibility pour effectuer un contrôle complet ou sélectionner des règles ciblant des problèmes précis, tels que l’absence de texte alternatif pour les images ou un contraste de couleurs insuffisant.

Un HTML accessible aide les personnes qui utilisent un lecteur d’écran, la navigation au clavier, le grossissement ou d’autres technologies d’assistance à interagir avec le contenu web. Des contrôles réguliers permettent aux équipes de développement de détecter rapidement les problèmes et de maintenir les pages conformes aux recommandations WCAG lorsque le contenu évolue.

Choisir un processus de vérification de l’accessibilité web

Valider le HTML selon les niveaux A et AA des WCAG

Cet exemple sélectionne les critères des niveaux A et AA des WCAG et active les règles applicables aux technologies HTML et CSS. Il valide ensuite le document et exporte les erreurs et avertissements détectés.

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

// Select WCAG Level A and AA checks for HTML and CSS technologies
ValidationBuilder validationPolicy = ValidationBuilder.None
    .UseHTML()
    .UseCSS()
    .UseLowestLevel()
    .UseMiddleLevel();

AccessibilityValidator validator = webAccessibility.CreateValidator(
    validationPolicy);

// Validate the document and export detected issues
using HTMLDocument document = new HTMLDocument(documentPath);
ValidationResult validationResult = validator.Validate(document);

Console.WriteLine($"Validation passed: {validationResult.Success}");

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

Créer un processus de validation de l’accessibilité

1. Choisissez l’étendue de la validation parmi tous les contrôles disponibles, des niveaux et technologies précis, un objet de la hiérarchie WCAG ou une liste explicite de règles.
2. Créez un objet WebAccessibility et configurez un AccessibilityValidator .
3. Chargez un fichier local ou l’URL d’une page web dans un HTMLDocument .
4. Appelez Validate() et traitez l’objet ValidationResult renvoyé.
5. Enregistrez les problèmes détectés automatiquement, corrigez la source et complétez le processus avec les tests manuels d’accessibilité requis.

Fonctions de l’API d’accessibilité web

• Validation configurable. Utilisez toutes les règles du référentiel ou filtrez les contrôles par niveau de conformité, technologie, balise HTML, principe, règle, critère ou code.
• Contrôles ciblés. Créez des processus dédiés aux textes alternatifs, aux libellés, à la structure du document, au contraste des couleurs et à d’autres exigences prises en charge.
• Résultats détaillés. Examinez les résultats des règles et techniques, les types et messages d’erreur, ainsi que les cibles HTML ou CSS associées aux problèmes détectés.
• Exportation des rapports. Enregistrez les résultats au format texte, JSON ou XML pour les révisions, les journaux et les contrôles qualité automatisés.
• Intégration aux applications. Exécutez la même politique dans le traitement de contenu, la validation d’un CMS, les tests ou les pipelines CI/CD.
• Limites définies. Les contrôles automatiques facilitent l’évaluation de l’accessibilité, mais ne certifient pas à eux seuls une conformité WCAG complète.

Pour effectuer un contrôle ponctuel sans écrire de code, utilisez le vérificateur d’accessibilité web en ligne .

Documentation sur l’accessibilité web

Commencez par la documentation Vérifier l’accessibilité web en C# . Consultez Accessibility Validator – vérification selon les WCAG pour configurer le validateur, Règles d’accessibilité du Web pour comprendre la hiérarchie du référentiel et Enregistrer les résultats de validation de l’accessibilité pour connaître les formats de rapport.

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 l’API d’accessibilité web

1. Quels contrôles d’accessibilité Aspose.HTML for .NET peut-il automatiser ?

L’API peut évaluer le HTML selon les règles d’accessibilité prises en charge, notamment les contrôles liés aux textes alternatifs, aux libellés, à la structure, au CSS et au contraste des couleurs. La couverture exacte dépend des règles, technologies et niveaux de conformité sélectionnés.

2. Dois-je valider toutes les règles ou sélectionner un ensemble plus restreint ?

Utilisez une validation étendue pour un examen général. Sélectionnez des niveaux, technologies, balises, critères ou codes précis lorsqu’un projet applique une politique définie ou nécessite un retour rapide sur un composant. Un ensemble restreint de règles ne constitue pas un audit complet.

3. Les contrôles d’accessibilité web peuvent-ils être exécutés dans un pipeline CI/CD ?

Oui. Exécutez le validateur pendant les tests ou la génération du contenu, exportez les résultats et appliquez les conditions propres au projet pour décider si le pipeline doit afficher un avertissement ou échouer. Les tests manuels d’accessibilité restent une étape distincte du processus de publication.