API de Acessibilidade Web para C#

Verificar acessibilidade web com uma API .NET

Aspose.HTML for .NET fornece APIs para verificar a acessibilidade de arquivos HTML e páginas web. Use o namespace Aspose.Html.Accessibility para executar uma verificação completa ou selecionar regras para problemas específicos, como ausência de texto alternativo em imagens e contraste de cores insuficiente.

Um HTML acessível ajuda pessoas que usam leitores de tela, navegação por teclado, ampliação e outras tecnologias assistivas a interagir com o conteúdo web. Verificações regulares ajudam as equipes a encontrar problemas cedo e manter as páginas alinhadas às WCAG após alterações no conteúdo.

Escolha um fluxo de acessibilidade web

Validar HTML com os níveis A e AA das WCAG

Este exemplo seleciona critérios dos níveis A e AA das WCAG e habilita regras para as tecnologias HTML e CSS. Ele valida o documento e exporta os erros e avisos 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());
}

Criar um fluxo de validação de acessibilidade

1. Escolha o escopo da validação entre todas as verificações disponíveis, níveis e tecnologias selecionados, um objeto da hierarquia WCAG ou uma lista explícita de regras.
2. Crie um objeto WebAccessibility e configure um AccessibilityValidator .
3. Carregue um arquivo local ou a URL de uma página web em um HTMLDocument .
4. Chame Validate() e processe o ValidationResult retornado.
5. Registre os problemas encontrados automaticamente, corrija o código-fonte e conclua o fluxo com os testes manuais de acessibilidade necessários.

Recursos da API de acessibilidade web

• Validação configurável. Use todas as regras do repositório ou filtre as verificações por nível de conformidade, tecnologia, tag HTML, princípio, diretriz, critério ou código de regra.
• Verificações direcionadas. Crie fluxos específicos para textos alternativos, rótulos, estrutura do documento, contraste de cores e outros requisitos compatíveis.
• Resultados detalhados. Analise resultados de regras e técnicas, tipos de erro, mensagens e os elementos HTML ou CSS associados aos problemas detectados.
• Exportação de relatórios. Salve os resultados como texto, JSON ou XML para revisões, logs e processos automatizados de qualidade.
• Integração com aplicações. Execute a mesma política em processamento de conteúdo, validação de CMS, testes ou pipelines de CI/CD.
• Limites definidos. As verificações automáticas apoiam o trabalho de acessibilidade, mas não certificam a conformidade total com as WCAG sem avaliação manual.

Para uma verificação ocasional sem escrever código, use o Web Accessibility Checker online .

Documentação de acessibilidade web

Comece pela visão geral Web Accessibility . Consulte Accessibility Validator para configuração, Web Accessibility Rules para a hierarquia do repositório e Save Validation Results para os formatos de relatório.

Instalar o Aspose.HTML for .NET

Instale o Aspose.HTML for .NET pelo NuGet usando a CLI do .NET:

dotnet add package Aspose.HTML

Você também pode usar a interface do Gerenciador de Pacotes NuGet ou executar Install-Package Aspose.HTML no Console do Gerenciador de Pacotes. Consulte o guia de instalação para configurar a biblioteca ou solicite uma licença temporária para avaliar a API sem limitações.

Perguntas frequentes sobre a API de acessibilidade web

1. Quais verificações de acessibilidade o Aspose.HTML for .NET pode automatizar?

A API pode avaliar HTML com regras de acessibilidade compatíveis, incluindo texto alternativo, rótulos, estrutura, CSS e contraste de cores. A cobertura exata depende das regras, tecnologias e níveis de conformidade selecionados.

2. Devo validar todas as regras ou selecionar um conjunto menor?

Use uma validação ampla para uma revisão geral. Selecione níveis, tecnologias, tags, critérios ou códigos de regras quando o projeto tiver uma política definida ou precisar de respostas rápidas para um componente específico. Um conjunto limitado não equivale a uma auditoria completa.

3. As verificações de acessibilidade web podem ser executadas em CI/CD?

Sim. Execute o validador durante testes ou builds, exporte os resultados e aplique condições específicas do projeto para decidir se o pipeline deve emitir um aviso ou falhar. Os testes manuais continuam sendo uma etapa separada do processo de lançamento.