Валідатор доступності HTML на C#

Перевірка доступності HTML за допомогою .NET API

Aspose.HTML for .NET надає AccessibilityValidator для перевірки HTML-документів за правилами WCAG. Перевіряйте локальні файли чи вебсторінки, визначайте невдалі перевірки та пов’язані елементи й експортуйте результати у звіт.

Регулярна перевірка допомагає командам знаходити проблеми доступності до публікації та застосовувати однакові правила після кожної зміни HTML.

Перевірка HTML-документа на C#

Створіть валідатор з усіма доступними налаштуваннями, перевірте документ і переберіть лише невдалі результати. Читайте ruleResult.Results, щоб отримати кожну невдалу техніку, навіть якщо окрема колекція Errors порожня.

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();
AccessibilityValidator validator = webAccessibility.CreateValidator(
    ValidationBuilder.All);

// Validate the HTML document against the configured rules
using HTMLDocument document = new HTMLDocument(documentPath);
ValidationResult validationResult = validator.Validate(document);

foreach (RuleValidationResult ruleResult in validationResult.Details)
{
    if (ruleResult.Success)
    {
        continue;
    }

    Console.WriteLine($"{ruleResult.Rule.Code}: {ruleResult.Rule.Description}");

    // Inspect every technique result, including entries without an error object
    foreach (ITechniqueResult techniqueResult in ruleResult.Results)
    {
        if (techniqueResult.Success)
        {
            continue;
        }

        Console.WriteLine(
            $"  {techniqueResult.Rule.Code}: {techniqueResult.Rule.Description}");

        IError error = techniqueResult.Error;
        if (error == null)
        {
            continue;
        }

        Console.WriteLine($"    {error.ErrorTypeName}: {error.ErrorMessage}");

        if (error.Target?.TargetType == TargetTypes.HTMLElement &&
            error.Target.Item is HTMLElement element)
        {
            Console.WriteLine($"    {element.OuterHTML}");
        }
    }
}

Як перевірити доступність HTML

1. Створіть об’єкт WebAccessibility , що надає доступ до створення валідатора та сховища правил.
2. Викличте CreateValidator(ValidationBuilder.All), щоб створити валідатор для всіх правил, які відповідають повним налаштуванням builder.
3. Завантажте файл або URL в HTMLDocument .
4. Викличте Validate() і збережіть повернений ValidationResult .
5. Переберіть Details, виберіть невдалі об’єкти RuleValidationResult і перевірте техніки в Results. Виведіть відомості про помилку та пов’язаний HTML-елемент, якщо вони доступні.

Налаштування й обробка перевірок доступності

• Повна перевірка. ValidationBuilder.All застосовує до правил усі доступні рівні й технології.
• Фільтрована перевірка. Обмежуйте перевірку за рівнем, технологією, HTML-тегом, принципом, настановою, критерієм або списком правил.
• Докладна діагностика. ValidationResult.Details містить результати правил, а помилки технік – повідомлення й пов’язані елементи.
• Локальний і віддалений HTML. HTMLDocument може завантажити HTML-файл або URL вебсторінки.
• Експорт результатів. Звіти можна обробити в коді або зберегти як текст, JSON чи XML.
• Ручна перевірка. Автоматичні результати слід доповнювати тестуванням клавіатури, допоміжних технологій, вмісту й зручності використання.

Для одноразової перевірки без коду скористайтеся Web Accessibility Checker . Використовуйте .NET API, коли перевірку потрібно налаштовувати, повторювати або інтегрувати в процес розробки.

Документація валідатора доступності

У посібнику Accessibility Validator описано перевантаження CreateValidator() і фільтри ValidationBuilder. Про обробку невдалих технік та елементів читайте в Errors and Warnings , а про експорт звітів – у Save Validation Results .

Установлення Aspose.HTML for .NET

Установіть Aspose.HTML for .NET з NuGet за допомогою .NET CLI:

dotnet add package Aspose.HTML

Також можна скористатися інтерфейсом диспетчера пакетів NuGet або виконати Install-Package Aspose.HTML у консолі диспетчера пакетів. Докладні інструкції наведено в посібнику зі встановлення . Щоб оцінити API без обмежень ознайомлювальної версії, запросіть тимчасову ліцензію .

Запитання про валідатор доступності HTML

1. Як перевірити доступність HTML на C#?

Завантажте HTML-файл або URL через HTMLDocument, створіть AccessibilityValidator за допомогою WebAccessibility і викличте Validate(). Повернений ValidationResult містить стан і докладні результати оцінених правил.

2. Чи гарантує автоматичний валідатор відповідність WCAG?

Ні. Автоматична перевірка знаходить машинно перевірювані помилки, але багато вимог залежать від контексту й людської оцінки. Потрібні ручні тести клавіатури, допоміжних технологій і змісту.

3. Чи можна перевіряти локальні HTML-файли та вебсторінки?

Так. HTMLDocument завантажує локальний файл або URL. Віддалена перевірка залежить від мережі та можливості отримати таблиці стилів, сценарії й інші потрібні ресурси.

4. Чи можна перевірити лише вибрані правила або рівні WCAG?

Так. Фільтруйте за рівнем або технологією через ValidationBuilder чи створіть валідатор із принципом, настановою, критерієм або списком правил. Це зручно для цільової політики в конвеєрі.

5. Чи можна зберегти результати перевірки доступності?

Так. Використовуйте SaveToString() для текстового подання або SaveTo() з ValidationResultSaveFormat, щоб записати текст, JSON чи XML. Структурований результат можна архівувати або використовувати у звітах.