错误和警告 – 使用 Aspose.HTML 进行网页无障碍检查

Aspose.HTML for .NET 提供了 Aspose.Html.Accessibility 命名空间,该命名空间用于所有与网页无障碍相关的操作和检查。本文将介绍在检查网站是否符合 WCAG 标准时帮助收集错误和警告信息的类和接口。我们将特别关注失败标准和报告错误的方法,并查看在验证 HTML 文档后获取网页无障碍错误的 C# 示例。

您可以从 无障碍验证器 – C# 中的网站无障碍检查 文章中了解如何使用 AccessibilityValidator 类以编程方式检查网页无障碍性。

检测错误有助于识别可能阻止残障人士有效使用和与网页内容交互的障碍。错误和警告指导必须解决哪些问题以改善网页无障碍性。它们为开发人员和设计师提供了进行必要更改的路线图。

IError

IError 是一个包含验证错误信息的公共接口。这意味着一个错误的检查,即规则未通过 – 其结果与无障碍性不匹配。

属性	描述
ErrorMessage	返回错误或警告的字符串消息。
Target	返回发现错误的 HTML 或 CSS 元素。返回的对象类型为 Target。
ErrorTypeName	错误对象呈现的描述。它有两个选项:“Error"或"Warning”。
ErrorType	返回错误类型数值。
Success	此对象的结果。

IError 对象具有以下含义:

* ErrorType = 1 且 Success = false – 这意味着错误是严重的,检查结果未执行。
* ErrorType = 2 且 Success = true – 这意味着错误不严重,但具有信息性质并显示可能改进的提示。

错误类型由技术类型决定:

• 如果某项技术未能满足所需的成功标准,并且该标准是必须满足的,则结果将被标记为严重失败,导致 ErrorType=1 和 Success=false,这是一个错误。
• 如果某项技术不是严格要求的,或者问题更多是最佳实践或改进建议而不是严格违反规则,则将被标记为 ErrorType=2 和 Success=true,这是一个警告。

Target

Target 是一个公共类,包含发现错误的文档的 HTML 或 CSS 元素项。

属性	描述
Item	返回 html 或 css 元素的对象。
TargetType	返回包含对象的类型。对象类型为 TargetTypes。

TargetTypes

TargetTypes 是包含错误的 HTML 文档元素类型的枚举:

值	描述
HTMLElement	包含文档中 HTMLElement 的元素。
CSSStyleRule	包含文档中 CSSStyleRule 的元素。
CSSStyleSheet	包含文档中 CSSStyleSheet 的元素。

让我们看一下用于遍历网页无障碍检查结果的 C# 代码,特别关注失败标准和报告错误的方法的详细信息。获取 HTML 文档的错误详细信息和元素的示例:

1. 使用 RuleValidationResult 类并遍历 validationResult.Details 中包含的 ruleResult 对象。这些代表不同的无障碍标准。
2. 打印标准的代码和描述以及它是否成功。为此,使用 IRule 接口的 Code 和 Description 属性。
3. 使用 Success 属性检查标准。
4. 使用 ITechniqueResult 对象 – ruleResult.Errors 中包含的 ruleDetail。 ITechniqueResult 对象表示报告错误的标准的各个规则结果。
5. 打印有关方法的信息,包括方法代码、成功状态和描述。
6. 使用 IError 属性从 ruleDetail 获取 error 对象。ruleDetail 表示特定的无障碍问题,error 对象包含有关该问题的信息。
7. 使用 Target 属性检索与错误相关的 target 对象。target 对象通常表示触发无障碍错误的特定 HTML 元素、CSS 规则或其他内容。
8. 打印有关错误的信息。它包括错误类型 (error.ErrorTypeName) 和错误消息 (error.ErrorMessage)。
9. 使用 Target 类的 TargetType 属性检查目标对象的类型。根据目标对象的类型,提取特定信息并打印到控制台。

// Check HTML for WCAG compliance and output failed rule codes and error messages

// Initialize a webAccessibility container
WebAccessibility webAccessibility = new WebAccessibility();

// Create an accessibillity validator with static instance for all rules from repository that match the builder settings
AccessibilityValidator validator = webAccessibility.CreateValidator(ValidationBuilder.All);

string documentPath = Path.Combine(DataDir, "input.html");

// Initialize an object of the HTMLDocument class
using (HTMLDocument document = new HTMLDocument(documentPath))
{
    // Check the document
    ValidationResult validationResult = validator.Validate(document);

    foreach (RuleValidationResult ruleResult in validationResult.Details)
    {
        //  list only unsuccessful rule
        if (!ruleResult.Success)
        {
            // print the code and description of the rule
            Console.WriteLine("{0}:{1} = {2}", ruleResult.Rule.Code, ruleResult.Rule.Description, ruleResult.Success);
            // print the results of methods with errors
            foreach (ITechniqueResult ruleDetail in ruleResult.Errors)
            {
                // print the code and description of the method
                StringBuilder str = new StringBuilder(string.Format("\n{0}: {1} - {2}",
                                                           ruleDetail.Rule.Code, ruleDetail.Success,
                                                           ruleDetail.Rule.Description));
                // get an error object 
                IError error = ruleDetail.Error;
                // get a target object 
                Target target = error.Target;
                // get error type and message 
                str.AppendFormat("\n\n\t{0} : {1}", error.ErrorTypeName, error.ErrorMessage);
                if (target != null)
                {
                    // Checking the type of the contained object for casting and working with it
                    if (target.TargetType == TargetTypes.CSSStyleRule)
                    {
                        ICSSStyleRule cssRule = (ICSSStyleRule)target.Item;
                        str.AppendFormat("\n\n\t{0}", cssRule.CSSText);
                    }
                    if (ruleDetail.Error.Target.TargetType == TargetTypes.CSSStyleSheet)
                        str.AppendFormat("\n\n\t{0}", ((ICSSStyleSheet)target.Item).Title);

                    if (ruleDetail.Error.Target.TargetType == TargetTypes.HTMLElement)
                        str.AppendFormat("\n\n\t{0}", ((HTMLElement)target.Item).OuterHTML);
                }
                Console.WriteLine(str.ToString());
            }
        }
    }
}

另请参阅

• 在 网页无障碍检查 章节中,您将学习如何使用 Aspose.Html.Accessibility 和 Aspose.Html.Accessibility.Results 命名空间的类和方法检查网站是否符合所有 WCAG 标准或仅满足特定标准。
• 文章 如何改善网站无障碍性 解释了如何使您的网站对用户无障碍,以及如何使用 Aspose.HTML API for .NET 检查您的网站是否符合 WCAG 标准。
• 文章 屏幕阅读器无障碍性 解释了如何使用 Aspose.HTML for .NET API 根据 WCAG 指南设计屏幕阅读器无障碍的网站。
• 在文章 无障碍验证器 中,您将了解可用于测试网页无障碍规则(如原则、指南和标准)的 AccessibilityValidator 类。
• 在文章 网页无障碍规则 中,您将学习如何使用 AccessibilityRules 类,该类是 WCAG 2 要求、成功标准和技术的存储库,用于网页无障碍检查。

Aspose.HTML 提供免费的在线 网页无障碍检查器。此工具扫描网页,验证它们是否符合 WCAG 标准,识别问题并提出改进建议。立即了解您网站的合规性,让您能够确定必要更正的范围以及您的网站或 HTML 文档当前状态与 WCAG 要求之间的差距。