Validator Aksesibilitas HTML dengan C#

Memvalidasi Aksesibilitas HTML dengan API .NET

Aspose.HTML for .NET menyediakan AccessibilityValidator untuk memeriksa dokumen HTML berdasarkan aturan aksesibilitas WCAG. Validasi file lokal atau halaman web, identifikasi pemeriksaan yang gagal dan elemen yang terdampak, lalu ekspor hasilnya sebagai laporan.

Validasi berkala membantu tim pengembangan menemukan masalah aksesibilitas sebelum publikasi dan menerapkan pemeriksaan yang sama setiap kali konten HTML berubah.

Memvalidasi Dokumen HTML dengan C#

Buat validator dengan semua pengaturan aturan yang tersedia, validasi dokumen, lalu ulangi hanya hasil yang gagal. Baca ruleResult.Results agar setiap teknik yang gagal dilaporkan meskipun koleksi Errors terpisahnya kosong.

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

Cara Memvalidasi Aksesibilitas HTML

1. Buat objek WebAccessibility yang menyediakan akses ke pembuatan validator dan repositori aturan aksesibilitas.
2. Panggil CreateValidator(ValidationBuilder.All) untuk membuat validator bagi semua aturan yang sesuai dengan pengaturan lengkap.
3. Muat file atau URL ke dalam HTMLDocument .
4. Panggil Validate() dan simpan ValidationResult yang dikembalikan.
5. Ulangi Details, pertahankan objek RuleValidationResult yang gagal, dan periksa teknik yang gagal di Results. Tampilkan detail kesalahan dan elemen HTML yang terdampak jika tersedia.

Mengonfigurasi dan Memproses Pemeriksaan Aksesibilitas

• Validasi lengkap. ValidationBuilder.All menerapkan setiap pengaturan level dan teknologi yang tersedia ke aturan dalam repositori.
• Validasi terfilter. Validator dapat dibatasi berdasarkan level, teknologi, tag HTML, prinsip, pedoman, kriteria, atau daftar aturan.
• Diagnostik terperinci. ValidationResult.Details menyediakan hasil aturan, sedangkan kesalahan teknik menampilkan pesan dan target yang terdampak.
• HTML lokal dan jarak jauh. HTMLDocument dapat memuat file HTML atau URL halaman web sebelum validasi.
• Hasil yang dapat diekspor. Laporan dapat diproses dalam kode atau disimpan sebagai teks, JSON, atau XML untuk peninjauan dan alur kerja otomatis.
• Verifikasi manual. Hasil otomatis harus dilengkapi dengan pengujian keyboard, teknologi bantu, konten, dan kegunaan.

Untuk pemindaian sesekali tanpa kode, gunakan Web Accessibility Checker online . Gunakan API .NET jika validasi perlu dikonfigurasi, diulang, atau diintegrasikan ke dalam pipeline pengembangan.

Dokumentasi Accessibility Validator

Panduan Accessibility Validator menjelaskan overload CreateValidator() yang tersedia dan filter ValidationBuilder. Baca Errors and Warnings untuk memproses teknik yang gagal dan elemen target, atau Save Validation Results untuk mengekspor laporan sebagai teks, JSON, atau XML.

Instal Aspose.HTML for .NET

Instal Aspose.HTML for .NET dari NuGet menggunakan .NET CLI:

dotnet add package Aspose.HTML

Anda juga dapat menggunakan antarmuka NuGet Package Manager atau menjalankan Install-Package Aspose.HTML di Package Manager Console. Lihat panduan instalasi untuk detail penyiapan, atau minta lisensi sementara untuk mengevaluasi API tanpa batasan evaluasi.

Tanya Jawab Validator Aksesibilitas HTML

1. Bagaimana cara memvalidasi aksesibilitas HTML dengan C#?

Muat file HTML atau URL dengan HTMLDocument, buat AccessibilityValidator dari WebAccessibility, lalu panggil Validate(). ValidationResult yang dikembalikan berisi status dan hasil terperinci untuk aturan yang dievaluasi oleh validator.

2. Dapatkah validator aksesibilitas otomatis menjamin kesesuaian terhadap WCAG?

Tidak. Validasi otomatis dapat mengidentifikasi kegagalan yang dapat diuji oleh perangkat lunak, tetapi banyak persyaratan bergantung pada konteks dan penilaian manusia. Pengujian keyboard dan teknologi bantu secara manual serta peninjauan makna konten tetap diperlukan.

3. Dapatkah validator memeriksa file HTML lokal dan halaman web?

Ya. HTMLDocument dapat memuat file lokal atau URL. Validasi jarak jauh bergantung pada akses jaringan dan kemampuan dokumen untuk mengambil stylesheet, skrip, dan sumber daya lain yang diperlukan oleh pemeriksaan terpilih.

4. Dapatkah saya memvalidasi hanya aturan atau level WCAG tertentu?

Ya. Gunakan ValidationBuilder untuk memfilter berdasarkan level atau teknologi, atau buat validator dengan prinsip, pedoman, kriteria, atau daftar aturan eksplisit. Pendekatan ini berguna jika pipeline memerlukan kebijakan terfokus, bukan seluruh repositori.

5. Dapatkah hasil validasi aksesibilitas disimpan?

Ya. Gunakan SaveToString() untuk representasi teks atau SaveTo() dengan ValidationResultSaveFormat untuk menulis teks, JSON, atau XML. Output terstruktur dapat diarsipkan atau digunakan oleh alur kerja pelaporan dan kontrol kualitas.