Validar reglas de accesibilidad WCAG en C#

Seleccionar reglas de accesibilidad web con una API .NET

Aspose.HTML for .NET proporciona un repositorio AccessibilityRules con los principios, las pautas, los criterios de conformidad y las técnicas de WCAG 2.0. Seleccione las reglas necesarias por código, cree un AccessibilityValidator y compruebe un archivo HTML o una página web para detectar problemas de accesibilidad relacionados.

La selección de reglas concretas resulta útil cuando un proyecto aplica una política de accesibilidad definida o necesita comprobar un tipo de problema. El informe de validación muestra qué comprobaciones fallaron y qué elementos HTML requieren atención.

Comprobar HTML con reglas WCAG seleccionadas

El ejemplo selecciona cuatro técnicas HTML relacionadas con alternativas para imágenes, etiquetas de formularios, títulos de iframe e identificadores únicos de elementos. GetRules() devuelve los objetos IRule correspondientes, que después se pasan a un validador específico.

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

Cómo validar reglas de accesibilidad específicas

1. Cree un objeto WebAccessibility y acceda a su repositorio Rules.
2. Defina los códigos de los principios, las pautas, los criterios o las técnicas que requiere la política de validación del proyecto.
3. Pase los códigos a GetRules() y compruebe que se hayan devuelto todas las reglas solicitadas.
4. Cree un AccessibilityValidator a partir del objeto IList<IRule> resultante.
5. Cargue el HTML con HTMLDocument , llame a Validate() y examine o guarde el informe devuelto.

Comprender la jerarquía de reglas de accesibilidad

• Principios. Las categorías de nivel superior de WCAG describen los objetivos generales del contenido accesible.
• Pautas. Cada principio contiene pautas que organizan requisitos de accesibilidad relacionados.
• Criterios de conformidad. Los criterios establecen requisitos verificables e identifican los niveles de conformidad A, AA o AAA.
• Técnicas y fallos. Los códigos de técnicas como H37 describen comprobaciones de implementación, mientras que los códigos de fallos identifican patrones que incumplen un criterio.
• Selección por código. GetRules() acepta uno o varios códigos y omite los que no se encuentran en el repositorio.
• Validación específica. Las reglas seleccionadas permiten realizar comprobaciones propias de un proyecto, pero una lista reducida no constituye una auditoría de accesibilidad completa.

Utilice el validador de accesibilidad HTML cuando la aplicación necesite una comprobación amplia o filtrada con el constructor en lugar de una lista explícita de códigos de reglas.

Documentación y referencia de reglas WCAG

Consulte Reglas de accesibilidad web para conocer la jerarquía completa del repositorio y ver ejemplos de GetPrinciple(), GetGuideline(), GetCriterion() y GetRules(). El índice de W3C Técnicas para las WCAG describe el propósito y el procedimiento de comprobación de los códigos de técnicas y fallos.

Instalar Aspose.HTML for .NET

Instale Aspose.HTML for .NET desde NuGet con la CLI de .NET:

dotnet add package Aspose.HTML

También puede usar la interfaz del Administrador de paquetes NuGet o ejecutar Install-Package Aspose.HTML en la consola del Administrador de paquetes. Consulte la guía de instalación para configurar la biblioteca o solicite una licencia temporal para evaluar la API sin limitaciones.

Preguntas frecuentes sobre las reglas de accesibilidad web

1. ¿Cuál es la diferencia entre un criterio WCAG y una técnica?

Un criterio de conformidad es un requisito verificable que se utiliza para determinar la conformidad con WCAG. Una técnica describe una forma documentada de cumplir un criterio, mientras que un fallo describe un patrón que lo incumple. Superar una técnica no demuestra por sí solo la conformidad.

2. ¿Cómo puedo validar solo determinadas reglas WCAG en C#?

Pase los códigos necesarios a AccessibilityRules.GetRules(), cree un AccessibilityValidator con el objeto IList<IRule> devuelto y valide el HTMLDocument. El informe quedará limitado al alcance de las reglas seleccionadas y a los ajustes aplicables del constructor.

3. ¿Puede GetRules() aceptar principios, pautas, criterios y técnicas?

Sí. Cada uno de estos tipos de regla implementa IRule, por lo que sus códigos pueden pasarse a GetRules(). Elija el nivel que corresponda al alcance previsto. Un objeto de nivel superior incluye un grupo más amplio, mientras que el código de una técnica selecciona una comprobación concreta.

4. ¿Qué ocurre si no se encuentra el código de una regla de accesibilidad solicitada?

El método GetRules() omite los códigos que no existen en el repositorio. Compare la colección devuelta con los códigos solicitados antes de validar para evitar que un error ortográfico o un código no compatible reduzcan el alcance previsto sin advertencia.

5. ¿La validación de reglas seleccionadas demuestra la conformidad con WCAG?

No. Solo demuestra que el documento se evaluó con las comprobaciones automáticas seleccionadas. La conformidad con WCAG exige evaluar los criterios aplicables, incluidos los requisitos que necesitan pruebas manuales y criterio humano.