Перевірка правил доступності WCAG на C#

Вибір правил вебдоступності за допомогою .NET API

Aspose.HTML for .NET надає сховище AccessibilityRules із принципами, настановами, критеріями успіху й техніками WCAG 2.0. Виберіть правила за кодом, створіть AccessibilityValidator і перевірте HTML-файл або вебсторінку.

Вибір окремих правил корисний, коли проєкт має визначену політику доступності або перевіряє певний тип проблем. Звіт показує невдалі перевірки та HTML-елементи, що потребують уваги.

Перевірка HTML за вибраними правилами WCAG

Приклад вибирає чотири HTML-техніки для альтернативного тексту зображень, міток форм, заголовків iframe та унікальних ID елементів. GetRules() повертає відповідні об’єкти IRule, які передаються цільовому валідатору.

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

Як перевірити конкретні правила доступності

1. Створіть об’єкт WebAccessibility і відкрийте його сховище Rules.
2. Визначте коди принципів, настанов, критеріїв або технік, потрібних політиці проєкту.
3. Передайте коди в GetRules() і переконайтеся, що повернуто всі запитані правила.
4. Створіть AccessibilityValidator з отриманого IList<IRule>.
5. Завантажте HTML через HTMLDocument , викличте Validate() і перегляньте або збережіть звіт.

Ієрархія правил доступності

• Принципи. Категорії найвищого рівня WCAG описують загальні цілі доступного вмісту.
• Настанови. Кожен принцип містить настанови, що групують пов’язані вимоги.
• Критерії успіху. Визначають перевірювані вимоги й рівні відповідності A, AA або AAA.
• Техніки й помилки. Коди на кшталт H37 описують перевірки реалізації, а коди помилок – шаблони, що порушують критерій.
• Вибір за кодом. GetRules() приймає один або кілька кодів і пропускає відсутні у сховищі.
• Цільова перевірка. Вибрані правила підтримують перевірки проєкту, але обмежений список не є повним аудитом доступності.

Використовуйте Валідатор доступності HTML , якщо застосунку потрібна широка або відфільтрована builder перевірка замість явного списку кодів.

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

Повну ієрархію та приклади GetPrinciple(), GetGuideline(), GetCriterion() і GetRules() наведено в Web Accessibility Rules . Покажчик W3C WCAG Techniques описує призначення й процедуру тестування кодів технік і помилок.

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

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

dotnet add package Aspose.HTML

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

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

1. Чим відрізняються критерій і техніка WCAG?

Критерій успіху – це перевірювана вимога для визначення відповідності WCAG. Техніка описує задокументований спосіб виконання критерію, а помилка – шаблон, що його порушує. Одна успішна техніка не доводить відповідність.

2. Як перевірити лише конкретні правила WCAG на C#?

Передайте коди в AccessibilityRules.GetRules(), створіть AccessibilityValidator з поверненим IList<IRule> і перевірте HTMLDocument. Звіт буде обмежено вибраними правилами й налаштуваннями builder.

3. Чи приймає GetRules() принципи, настанови, критерії й техніки?

Так. Кожен тип реалізує IRule, тому його код можна передати в GetRules(). Виберіть рівень відповідно до потрібного обсягу. Об’єкт вищого рівня охоплює ширшу групу, а код техніки – конкретну перевірку.

4. Що станеться, якщо код правила не знайдено?

Метод GetRules() пропускає код, якого немає у сховищі. Перед перевіркою порівняйте повернену колекцію із запитаними кодами, щоб помилка введення чи непідтримуваний код непомітно не звузили обсяг.

5. Чи доводить перевірка вибраних правил відповідність WCAG?

Ні. Вона лише підтверджує оцінювання документа вибраними автоматичними правилами. Для відповідності WCAG потрібно оцінити всі застосовні критерії, зокрема ті, що потребують ручного тестування.