Validar regras de acessibilidade WCAG em C#

Selecionar regras de acessibilidade web com uma API .NET

Aspose.HTML for .NET fornece um repositório AccessibilityRules com princípios, diretrizes, critérios de sucesso e técnicas das WCAG 2.0. Selecione as regras necessárias por código, crie um AccessibilityValidator e verifique um arquivo HTML ou página web.

Selecionar regras específicas é útil quando o projeto segue uma política de acessibilidade definida ou precisa testar um tipo de problema. O relatório mostra quais verificações falharam e quais elementos HTML exigem atenção.

Verificar HTML com regras WCAG selecionadas

O exemplo seleciona quatro técnicas HTML para alternativas de imagens, rótulos de formulário, títulos de iframe e IDs exclusivos. GetRules() retorna os objetos IRule correspondentes, que são passados a um validador direcionado.

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

Como validar regras de acessibilidade específicas

1. Crie um objeto WebAccessibility e acesse seu repositório Rules.
2. Defina os códigos dos princípios, diretrizes, critérios ou técnicas exigidos pela política de validação do projeto.
3. Passe os códigos para GetRules() e confirme se todas as regras solicitadas foram retornadas.
4. Crie um AccessibilityValidator usando o IList<IRule> resultante.
5. Carregue o HTML com HTMLDocument , chame Validate() e analise ou salve o relatório retornado.

Entender a hierarquia de regras de acessibilidade

• Princípios. As categorias superiores das WCAG descrevem os objetivos gerais do conteúdo acessível.
• Diretrizes. Cada princípio contém diretrizes que organizam requisitos de acessibilidade relacionados.
• Critérios de sucesso. Fornecem requisitos testáveis e identificam os níveis de conformidade A, AA ou AAA.
• Técnicas e falhas. Códigos como H37 descrevem verificações de implementação; códigos de falha identificam padrões que violam um critério.
• Seleção por código. GetRules() aceita um ou mais códigos e omite os que não existem no repositório.
• Validação direcionada. Regras selecionadas permitem verificações específicas, mas uma lista limitada não constitui uma auditoria completa.

Use o Validador de Acessibilidade HTML quando a aplicação precisar de uma verificação ampla ou filtrada pelo builder em vez de uma lista explícita de códigos.

Documentação e referência de regras WCAG

Leia Web Accessibility Rules para conhecer a hierarquia completa e exemplos de GetPrinciple(), GetGuideline(), GetCriterion() e GetRules(). O índice WCAG Techniques do W3C descreve a finalidade e o procedimento de teste de cada técnica e código de falha.

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 regras de acessibilidade web

1. Qual é a diferença entre um critério e uma técnica das WCAG?

Um critério de sucesso é um requisito testável usado para determinar a conformidade com as WCAG. Uma técnica descreve uma forma documentada de atender ao critério, enquanto uma falha descreve um padrão que não o atende. Passar em uma técnica não comprova conformidade.

2. Como validar apenas regras WCAG específicas em C#?

Passe os códigos para AccessibilityRules.GetRules(), crie um AccessibilityValidator com o IList<IRule> retornado e valide o HTMLDocument. O relatório será limitado ao escopo selecionado e às configurações aplicáveis do builder.

3. GetRules() aceita princípios, diretrizes, critérios e técnicas?

Sim. Todos esses tipos implementam IRule, portanto seus códigos podem ser passados para GetRules(). Escolha o nível correspondente ao escopo desejado; um objeto superior inclui um grupo mais amplo, enquanto o código de uma técnica direciona uma verificação específica.

4. O que acontece se um código de regra não for encontrado?

O método GetRules() omite códigos ausentes do repositório. Compare a coleção retornada com os códigos solicitados antes da validação para evitar que erros de digitação ou códigos incompatíveis reduzam o escopo pretendido.

5. Validar regras selecionadas comprova conformidade com as WCAG?

Não. Isso apenas demonstra que o documento foi avaliado pelas verificações automáticas selecionadas. A conformidade exige avaliar os critérios aplicáveis, incluindo requisitos que dependem de testes manuais e julgamento humano.