Сохранить результаты проверки веб-доступности – C#

Aspose.HTML for .NET предоставляет пространство имен Aspose.Html.Accessibility, которое предназначено для всех манипуляций и проверок, связанных с веб-доступностью. В этой статье мы рассмотрим процесс сохранения результатов проверки с использованием библиотеки Aspose.HTML .NET, уделяя особое внимание параметру ValidationResultSaveFormat.

Как использовать класс AccessibilityValidator для проверки веб-доступности вы можете узнать из статьи Accessibility Validator – Проверка доступности веб-сайта на C#.

Сохранение результатов проверки

Проверка доступности веб-сайтов имеет решающее значение для обеспечения соответствия веб-контента правилам и стандартам WCAG. После завершения процесса проверки вам необходимо сохранить результаты для дальнейшего анализа, документирования и отчетности. Наша библиотека позволяет сохранять результаты проверки в объект System.IO.TextWriter, где параметр типа ValidationResultSaveFormat указывает, в каком формате будет сохранен текст.

ValidationResultSaveFormat

Для сохранения результатов проверки веб-доступности доступны три основных формата:

• Тext
• JSON
• XML

Сохранение результатов проверки в строку

При сохранении результатов проверки в строку используется метод SaveToString():

// Validate HTML for accessibility and export all errors and warnings as a string

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

using (HTMLDocument document = new HTMLDocument(htmlPath))
{
    AccessibilityValidator validator = new WebAccessibility().CreateValidator();

    ValidationResult validationresult = validator.Validate(document);

    // get rules errors in string format 
    string content = validationresult.SaveToString();

    // SaveToString - return only errors and warnings
    // if everything is ok, it will return "validationResult:true"
    Console.WriteLine(content);
}

Вывод представляется в простом текстовом формате, четко указывая результат проверки и предоставляя подробную информацию об ошибках с комментариями:

validationResult:False;
%%
technique: H35;
criterion: 1.1.1;
type: Error;
description: Check that the applet element contains an alt attribute with a text alternative for the applet. ;
source: <applet code="tictactoe.class" width="250" height="250">tic-tac-toe game</applet>;
%%
technique: H37;
criterion: 1.1.1;
type: Error;
description: Img element missing an alt attribute. The value of this attribute is referred to as "alt text".;
source: <img src="image1.jpeg">;
%%

...

В тексте указан результат проверки validationResult, а также список ошибок и комментариев:

• technique – код проверенной методики
• criterion – критерии, которым соответствует методика
• type – тип результата
• description – описание ошибки
• source – тег, содержащий ошибку

Сохранение результатов проверки в формате XML

Для тех, кто предпочитает более структурированный и машиночитаемый формат, хранение результатов проверки в XML является подходящим выбором. Давайте посмотрим, как сохранить результаты в формате XML с помощью метода SaveTo(). Этот метод принимает объект System.IO.TextWriter и желаемый ValidationResultSaveFormat, в данном случае XML.

// Validate HTML for accessibility and export all errors and warnings as an XML

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

using (HTMLDocument document = new HTMLDocument(htmlPath))
{
    AccessibilityValidator validator = new WebAccessibility().CreateValidator();
    ValidationResult validationresult = validator.Validate(document);
    
    using (StringWriter sw = new StringWriter())
    {
        validationresult.SaveTo(sw, ValidationResultSaveFormat.XML);
        string xml = sw.ToString();

        Console.WriteLine(xml);

        try
        {
            XmlDocument doc = new XmlDocument();
            doc.LoadXml(xml);
        }
        catch (Exception)
        {
            Console.WriteLine("Wrong xml format");
        }
    }
}

Полученное XML-представление представляет собой хорошо организованный формат для удобного анализа и дальнейшей обработки:

<validationResult>
<isValid>false</isValid>
<details>
  <techniqueResult>
    <technique>H35</technique>
    <criterion>1.1.1</criterion>
    <type>Error</type>
    <description>Check that the applet element contains an alt attribute with a text alternative for the applet. </description>
    <source><![CDATA[<applet code="tictactoe.class" width="250" height="250">tic-tac-toe game</applet>]]>
    </source>
  </techniqueResult>
  <techniqueResult>
    <technique>H37</technique>
    <criterion>1.1.1</criterion>
    <type>Error</type>
    <description>Img element missing an alt attribute. The value of this attribute is referred to as "alt text".</description>
    <source><![CDATA[<img src="image1.jpeg">]]>
    </source>
  </techniqueResult>
  
   ...

 </details>
</validationResult>

Сохранение результатов является неотъемлемым этапом проверки доступности веб-сайтов и облегчает последующий анализ, документирование и составление отчетов. Параметр ValidationResultSaveFormat обеспечивает гибкость, позволяя вам выбирать между форматами Text, JSON и XML в зависимости от ваших конкретных потребностей.

Смотрите также

• Статья Альтернативный Текст – Веб-доступность объясняет, как разработать веб-сайт для доступности экранного ридера в соответствии с рекомендациями WCAG с использованием API Aspose.HTML for .NET.
• Ознакомьтесь со статьей Доступность цветового контраста, если вы хотите узнать, как правильно настроить контрастность вашего веб-контента в соответствии со стандартами WCAG, мирового авторитета в области веб-доступности. Вы узнаете, как проверить доступность цветового контраста с помощью C# и сделать ваш веб-контент удобным для чтения для всех пользователей.
• В статье Правила веб-доступности вы узнаете, как использовать класс AccessibilityRules, который является репозиторием требований WCAG 2, критериев успеха и методов для проверок веб-доступности.
• В статье Ошибки и предупреждения обсуждаются классы и интерфейсы, которые помогают собирать информацию об ошибках и предупреждениях во время тестирования доступности веб-сайта. В ней основное внимание уделяется критериям отказа и методам, которые сообщают об ошибках, и приводится пример C# для извлечения ошибок веб-доступности после тестирования HTML-документа.
  

Aspose.HTML предлагает бесплатный онлайн-сервис Проверка веб-доступности. Этот инструмент сканирует веб-страницы, проверяет их на соответствие WCAG, выявляет проблемы и предлагает улучшения. Получайте мгновенную информацию о соответствии вашего веб-сайта требованиям, что позволит вам определить объем необходимых исправлений и разрыв между текущим состоянием вашего веб-сайта или HTML-документа и требованиями WCAG.