Validador de accesibilidad HTML en C#

Validar la accesibilidad de HTML con una API .NET

Aspose.HTML for .NET proporciona un AccessibilityValidator para comprobar documentos HTML con las reglas de accesibilidad WCAG. Valide un archivo local o una página web, identifique las comprobaciones fallidas y los elementos afectados, y exporte los resultados como informe.

La validación periódica permite a los equipos de desarrollo detectar problemas de accesibilidad antes de publicar el contenido y aplicar las mismas comprobaciones cada vez que cambia el HTML.

Validar un documento HTML en C#

Cree un validador con todos los ajustes de reglas disponibles, valide el documento y recorra únicamente los resultados fallidos. Consulte ruleResult.Results para incluir cada técnica fallida, aunque su colección Errors independiente esté vacía.

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

Cómo validar la accesibilidad de HTML

1. Cree un objeto WebAccessibility para acceder a la creación de validadores y al repositorio de reglas de accesibilidad.
2. Llame a CreateValidator(ValidationBuilder.All) para crear un validador con todas las reglas que coincidan con la configuración completa.
3. Cargue un archivo o una URL en un HTMLDocument .
4. Llame a Validate() y guarde el objeto ValidationResult devuelto.
5. Recorra Details, conserve los objetos RuleValidationResult fallidos y examine las técnicas fallidas de Results. Muestre los detalles del error y el elemento HTML afectado cuando estén disponibles.

Configurar y procesar comprobaciones de accesibilidad

• Validación completa. ValidationBuilder.All aplica todos los ajustes disponibles de nivel y tecnología a las reglas del repositorio.
• Validación filtrada. El validador puede limitarse por nivel, tecnología, etiqueta HTML, principio, pauta, criterio o lista de reglas.
• Diagnósticos detallados. ValidationResult.Details contiene los resultados de las reglas, mientras que los errores de las técnicas muestran los mensajes y los destinos afectados.
• HTML local y remoto. HTMLDocument puede cargar un archivo HTML o la URL de una página web antes de la validación.
• Resultados exportables. Los informes pueden procesarse mediante código o guardarse como texto, JSON o XML para revisiones y flujos automatizados.
• Verificación manual. Los resultados automáticos deben complementarse con pruebas de teclado, tecnologías de asistencia, contenido y usabilidad.

Para realizar una comprobación ocasional sin código, utilice el comprobador de accesibilidad web en línea . Utilice la API .NET cuando necesite configurar, repetir o integrar la validación en un proceso de desarrollo.

Documentación de Accessibility Validator

La guía Validador de accesibilidad – comprobación según WCAG explica las sobrecargas disponibles de CreateValidator() y los filtros de ValidationBuilder. Consulte Errores y advertencias – comprobación de accesibilidad web para procesar técnicas fallidas y elementos afectados, o Guardar resultados de validación de accesibilidad para exportar informes como texto, JSON o XML.

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 el validador de accesibilidad HTML

1. ¿Cómo puedo validar la accesibilidad de HTML en C#?

Cargue el archivo HTML o la URL con HTMLDocument, cree un AccessibilityValidator a partir de WebAccessibility y llame a Validate(). El objeto ValidationResult devuelto contiene el estado y los resultados detallados de las reglas evaluadas.

2. ¿Puede un validador automático garantizar la conformidad con WCAG?

No. La validación automática puede identificar errores comprobables por software, pero muchos requisitos dependen del contexto y del criterio humano. También se necesitan pruebas manuales con teclado y tecnologías de asistencia, además de revisar el significado del contenido.

3. ¿Puede el validador comprobar archivos HTML locales y páginas web?

Sí. HTMLDocument puede cargar un archivo local o una URL. La validación remota depende del acceso a la red y de que el documento pueda recuperar las hojas de estilo, los scripts y otros recursos necesarios para las comprobaciones seleccionadas.

4. ¿Puedo validar solo determinadas reglas o niveles WCAG?

Sí. Utilice ValidationBuilder para filtrar por nivel o tecnología, o cree el validador con un principio, una pauta, un criterio o una lista explícita de reglas. Esto resulta útil cuando un proceso necesita una política específica en lugar del repositorio completo.

5. ¿Se pueden guardar los resultados de la validación de accesibilidad?

Sí. Utilice SaveToString() para obtener una representación de texto o SaveTo() con ValidationResultSaveFormat para escribir texto, JSON o XML. La salida estructurada puede archivarse o utilizarse en informes y procesos de control de calidad.