API de accesibilidad web para C#

Comprobar la accesibilidad web con una API .NET

Aspose.HTML for .NET proporciona API para comprobar la accesibilidad de archivos HTML y páginas web. Utilice el espacio de nombres Aspose.Html.Accessibility para realizar una comprobación completa o seleccionar reglas para problemas concretos, como la ausencia de texto alternativo en imágenes o un contraste de color insuficiente.

Un HTML accesible ayuda a las personas que utilizan lectores de pantalla, navegación por teclado, ampliación y otras tecnologías de asistencia a interactuar con el contenido web. Las comprobaciones periódicas permiten a los equipos de desarrollo detectar problemas con antelación y mantener las páginas alineadas con WCAG cuando cambia el contenido.

Elegir un flujo de trabajo de accesibilidad web

Validar HTML según los niveles A y AA de WCAG

Este ejemplo selecciona los criterios de los niveles A y AA de WCAG y activa las reglas para las tecnologías HTML y CSS. Después valida el documento y exporta los errores y las advertencias detectados.

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

Crear un flujo de validación de accesibilidad

1. Elija el alcance de la validación entre todas las comprobaciones disponibles, niveles y tecnologías seleccionados, un objeto de la jerarquía WCAG o una lista explícita de reglas.
2. Cree un objeto WebAccessibility y configure un AccessibilityValidator .
3. Cargue un archivo local o la URL de una página web en un HTMLDocument .
4. Llame a Validate() y procese el objeto ValidationResult devuelto.
5. Registre los problemas detectados automáticamente, corrija el código fuente y complete el proceso con las pruebas manuales de accesibilidad necesarias.

Funciones de la API de accesibilidad web

• Validación configurable. Utilice todas las reglas del repositorio o filtre las comprobaciones por nivel de conformidad, tecnología, etiqueta HTML, principio, pauta, criterio o código de regla.
• Comprobaciones específicas. Cree flujos centrados en textos alternativos, etiquetas, estructura del documento, contraste de color y otros requisitos compatibles.
• Resultados detallados. Examine los resultados de reglas y técnicas, los tipos y mensajes de error, y los elementos HTML o CSS asociados con los problemas detectados.
• Exportación de informes. Guarde los resultados como texto, JSON o XML para revisiones, registros y procesos automáticos de calidad.
• Integración en aplicaciones. Ejecute la misma política de forma repetida durante el procesamiento de contenido, la validación de un CMS, las pruebas o los procesos de CI/CD.
• Límites definidos. Las comprobaciones automáticas ayudan a evaluar la accesibilidad, pero no certifican por sí solas la conformidad completa con WCAG.

Para realizar una comprobación puntual sin escribir código, utilice el comprobador de accesibilidad web en línea .

Documentación sobre accesibilidad web

Comience con la guía Cómo comprobar la accesibilidad web en C# . Consulte Validador de accesibilidad – comprobación según WCAG para configurar el validador, Reglas de accesibilidad web para conocer la jerarquía del repositorio y Guardar resultados de validación de accesibilidad para revisar los formatos de informe.

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 la API de accesibilidad web

1. ¿Qué comprobaciones de accesibilidad puede automatizar Aspose.HTML for .NET?

La API puede evaluar HTML con las reglas de accesibilidad compatibles, incluidas comprobaciones relacionadas con textos alternativos, etiquetas, estructura, CSS y contraste de color. La cobertura exacta depende de las reglas, las tecnologías y los niveles de conformidad seleccionados.

2. ¿Debo validar todas las reglas o seleccionar un conjunto más pequeño?

Utilice una validación amplia para una revisión general. Seleccione niveles, tecnologías, etiquetas, criterios o códigos de reglas concretos cuando el proyecto tenga una política definida o necesite resultados rápidos para un componente específico. Un conjunto reducido de reglas no debe presentarse como una auditoría completa.

3. ¿Se pueden ejecutar comprobaciones de accesibilidad web en CI/CD?

Sí. Ejecute el validador durante las pruebas o la generación de contenido, exporte los resultados y aplique las condiciones del proyecto para decidir si el proceso debe mostrar una advertencia o detenerse. Las pruebas manuales de accesibilidad siguen siendo una parte independiente del proceso de publicación.