API вебдоступності для C#

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

Aspose.HTML for .NET надає API для перевірки доступності HTML-файлів і вебсторінок. Використовуйте простір імен Aspose.Html.Accessibility , щоб виконати повну перевірку або вибрати правила для конкретних проблем, наприклад відсутнього альтернативного тексту зображень чи недостатньої контрастності кольорів.

Доступний HTML допомагає людям, які користуються програмами зчитування з екрана, клавіатурною навігацією, збільшенням та іншими допоміжними технологіями. Регулярні перевірки дають змогу завчасно знаходити проблеми й підтримувати відповідність сторінок рекомендаціям WCAG після змін вмісту.

Виберіть сценарій перевірки вебдоступності

Перевірка HTML за рівнями WCAG A та AA

У цьому прикладі вибрано критерії WCAG рівнів A та AA й увімкнено правила для HTML і CSS. Код перевіряє документ та експортує знайдені помилки й попередження.

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

// Select WCAG Level A and AA checks for HTML and CSS technologies
ValidationBuilder validationPolicy = ValidationBuilder.None
    .UseHTML()
    .UseCSS()
    .UseLowestLevel()
    .UseMiddleLevel();

AccessibilityValidator validator = webAccessibility.CreateValidator(
    validationPolicy);

// Validate the document and export detected issues
using HTMLDocument document = new HTMLDocument(documentPath);
ValidationResult validationResult = validator.Validate(document);

Console.WriteLine($"Validation passed: {validationResult.Success}");

if (!validationResult.Success)
{
    Console.WriteLine(validationResult.SaveToString());
}

Створення процесу перевірки доступності

1. Виберіть область перевірки: усі доступні перевірки, окремі рівні й технології, об’єкт ієрархії WCAG або явний список правил.
2. Створіть об’єкт WebAccessibility і налаштуйте AccessibilityValidator .
3. Завантажте локальний файл або URL вебсторінки в HTMLDocument .
4. Викличте Validate() й опрацюйте повернений ValidationResult .
5. Збережіть автоматично знайдені проблеми, виправте вихідний код і завершіть процес необхідними ручними тестами доступності.

Можливості API вебдоступності

• Налаштовувана перевірка. Використовуйте всі правила сховища або фільтруйте їх за рівнем відповідності, технологією, HTML-тегом, принципом, настановою, критерієм чи кодом правила.
• Цільові перевірки. Створюйте окремі сценарії для альтернативного тексту, міток, структури документа, контрастності кольорів та інших підтримуваних вимог.
• Докладні результати. Переглядайте результати правил і технік, типи помилок, повідомлення та пов’язані з проблемами елементи HTML або CSS.
• Експорт звітів. Зберігайте результати як текст, JSON або XML для перевірок, журналів та автоматизованого контролю якості.
• Інтеграція в застосунки. Повторно застосовуйте ту саму політику під час обробки вмісту, перевірки CMS, тестування або в конвеєрах CI/CD.
• Визначені обмеження. Автоматичні перевірки допомагають покращувати доступність, але не підтверджують повну відповідність WCAG без ручного оцінювання.

Для одноразової перевірки без програмування скористайтеся онлайн-інструментом Web Accessibility Checker .

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

Почніть з огляду Web Accessibility . Налаштування описано в Accessibility Validator , ієрархію сховища правил – у Web Accessibility Rules , а формати звітів – у 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 без обмежень ознайомлювальної версії, запросіть тимчасову ліцензію .

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

1. Які перевірки доступності можна автоматизувати за допомогою Aspose.HTML for .NET?

API може оцінювати HTML за підтримуваними правилами, зокрема перевіряти альтернативний текст, мітки, структуру, CSS і контрастність кольорів. Точний обсяг залежить від вибраних правил, технологій і рівнів відповідності.

2. Перевіряти всі правила чи вибрати лише потрібні?

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

3. Чи можна виконувати перевірки вебдоступності в CI/CD?

Так. Запускайте валідатор під час тестів або збирання вмісту, експортуйте результати й застосовуйте умови проєкту, щоб конвеєр видавав попередження або завершувався з помилкою. Ручне тестування залишається окремим етапом випуску.