Memvalidasi Aturan Aksesibilitas WCAG dengan C#

Memilih Aturan Aksesibilitas Web dengan API .NET

Aspose.HTML for .NET menyediakan repositori AccessibilityRules yang berisi prinsip, pedoman, kriteria keberhasilan, dan teknik WCAG 2.0. Pilih aturan yang diperlukan berdasarkan kode, buat AccessibilityValidator, lalu periksa file HTML atau halaman web untuk menemukan masalah aksesibilitas terkait.

Pemilihan aturan tertentu berguna jika proyek mengikuti kebijakan aksesibilitas yang ditetapkan atau perlu menguji satu jenis masalah. Laporan validasi menunjukkan pemeriksaan yang gagal dan elemen HTML yang memerlukan perhatian.

Memeriksa HTML Berdasarkan Aturan WCAG yang Dipilih

Contoh ini memilih empat teknik HTML yang mencakup alternatif gambar, label formulir, judul iframe, dan ID elemen unik. GetRules() mengembalikan objek IRule yang sesuai, kemudian objek tersebut diteruskan ke validator terfokus.

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

Cara Memvalidasi Aturan Aksesibilitas Tertentu

1. Buat objek WebAccessibility dan akses repositori Rules miliknya.
2. Tentukan kode prinsip, pedoman, kriteria, atau teknik yang diperlukan oleh kebijakan validasi proyek.
3. Teruskan kode ke GetRules() dan pastikan setiap aturan yang diminta dikembalikan.
4. Buat AccessibilityValidator dari IList<IRule> yang dihasilkan.
5. Muat HTML dengan HTMLDocument , panggil Validate(), lalu periksa atau simpan laporan yang dikembalikan.

Memahami Hierarki Aturan Aksesibilitas

• Prinsip. Kategori WCAG tingkat atas menjelaskan tujuan umum konten yang mudah diakses.
• Pedoman. Setiap prinsip berisi pedoman yang mengelompokkan persyaratan aksesibilitas terkait.
• Kriteria keberhasilan. Kriteria menyediakan persyaratan yang dapat diuji dan mengidentifikasi level kesesuaian A, AA, atau AAA.
• Teknik dan kegagalan. Kode teknik seperti H37 menjelaskan pemeriksaan implementasi, sedangkan kode kegagalan mengidentifikasi pola yang melanggar suatu kriteria.
• Pemilihan berdasarkan kode. GetRules() menerima satu atau beberapa kode dan mengabaikan kode yang tidak tersedia dalam repositori.
• Validasi terfokus. Aturan terpilih dapat mendukung pemeriksaan khusus proyek, tetapi daftar aturan yang sempit bukan audit aksesibilitas lengkap.

Gunakan Validator Aksesibilitas HTML jika aplikasi memerlukan pemeriksaan luas atau terfilter berdasarkan builder, bukan daftar kode aturan eksplisit.

Dokumentasi dan Referensi Aturan WCAG

Baca Web Accessibility Rules untuk hierarki repositori lengkap serta contoh GetPrinciple(), GetGuideline(), GetCriterion(), dan GetRules(). Indeks W3C WCAG Techniques menjelaskan tujuan dan prosedur pengujian setiap kode teknik dan kegagalan.

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 Aturan Aksesibilitas Web

1. Apa perbedaan antara kriteria WCAG dan teknik?

Kriteria keberhasilan adalah persyaratan yang dapat diuji untuk menentukan kesesuaian terhadap WCAG. Teknik menjelaskan satu cara terdokumentasi untuk memenuhi kriteria, sedangkan kegagalan menjelaskan pola yang tidak memenuhinya. Lulus satu teknik saja tidak membuktikan kesesuaian.

2. Bagaimana cara memvalidasi hanya aturan WCAG tertentu dengan C#?

Teruskan kode yang diperlukan ke AccessibilityRules.GetRules(), buat AccessibilityValidator dengan IList<IRule> yang dikembalikan, lalu validasi HTMLDocument. Tindakan ini membatasi laporan pada cakupan aturan yang dipilih dan pengaturan builder yang berlaku.

3. Dapatkah GetRules() menerima prinsip, pedoman, kriteria, dan teknik?

Ya. Setiap jenis aturan tersebut mengimplementasikan IRule, sehingga kodenya dapat diteruskan ke GetRules(). Pilih tingkat yang sesuai dengan cakupan yang dimaksud. Objek tingkat lebih tinggi mencakup grup yang lebih luas, sedangkan kode teknik menargetkan pemeriksaan tertentu.

4. Apa yang terjadi jika kode aturan aksesibilitas yang diminta tidak ditemukan?

Metode GetRules() mengabaikan kode yang tidak ada dalam repositori. Bandingkan koleksi yang dikembalikan dengan kode yang diminta sebelum validasi agar kesalahan ejaan atau kode yang tidak didukung tidak mengurangi cakupan yang dimaksud tanpa diketahui.

5. Apakah validasi aturan terpilih membuktikan kesesuaian terhadap WCAG?

Tidak. Validasi hanya membuktikan bahwa dokumen telah dievaluasi berdasarkan pemeriksaan otomatis yang dipilih. Kesesuaian terhadap WCAG memerlukan penilaian atas kriteria keberhasilan yang berlaku, termasuk persyaratan yang membutuhkan pengujian manual dan pertimbangan manusia.