API Aksesibilitas Web untuk C#

Memeriksa Aksesibilitas Web dengan API .NET

Aspose.HTML for .NET menyediakan API untuk memeriksa aksesibilitas file HTML dan halaman web. Gunakan namespace Aspose.Html.Accessibility untuk menjalankan pemeriksaan lengkap atau memilih aturan bagi masalah tertentu, seperti teks alternatif gambar yang tidak tersedia dan kontras warna yang tidak memadai.

HTML yang mudah diakses membantu pengguna pembaca layar, navigasi keyboard, pembesaran layar, dan teknologi bantu lainnya berinteraksi dengan konten web. Pemeriksaan aksesibilitas secara berkala membantu tim pengembangan menemukan masalah lebih awal dan mempertahankan halaman yang sesuai dengan WCAG saat konten berubah.

Memilih Alur Kerja Aksesibilitas Web

Memvalidasi HTML Berdasarkan WCAG Level A dan AA

Contoh ini memilih kriteria WCAG Level A dan AA serta mengaktifkan aturan untuk teknologi HTML dan CSS. Kode kemudian memvalidasi dokumen dan mengekspor kesalahan serta peringatan yang terdeteksi.

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

Membuat Alur Kerja Validasi Aksesibilitas

1. Pilih cakupan validasi berupa semua pemeriksaan yang tersedia, level dan teknologi tertentu, objek hierarki WCAG, atau daftar aturan eksplisit.
2. Buat objek WebAccessibility dan konfigurasikan AccessibilityValidator .
3. Muat file lokal atau URL halaman web ke dalam HTMLDocument .
4. Panggil Validate() dan proses ValidationResult yang dikembalikan.
5. Catat temuan otomatis, perbaiki sumber, lalu lengkapi alur kerja dengan pengujian aksesibilitas manual yang diperlukan.

Kemampuan API Aksesibilitas Web

• Validasi yang dapat dikonfigurasi. Gunakan semua aturan repositori atau filter pemeriksaan berdasarkan level kesesuaian, teknologi, tag HTML, prinsip, pedoman, kriteria, atau kode aturan.
• Pemeriksaan terfokus. Buat alur kerja khusus untuk teks alternatif, label, struktur dokumen, kontras warna, dan persyaratan lain yang didukung.
• Hasil terperinci. Periksa hasil aturan dan teknik, jenis dan pesan kesalahan, serta target HTML atau CSS yang terkait dengan masalah yang terdeteksi.
• Ekspor laporan. Simpan hasil validasi sebagai teks, JSON, atau XML untuk peninjauan, log, dan proses kualitas otomatis.
• Integrasi aplikasi. Jalankan kebijakan yang sama secara berulang dalam pemrosesan konten, validasi CMS, pengujian, atau pipeline CI/CD.
• Batasan yang jelas. Pemeriksaan otomatis mendukung evaluasi aksesibilitas, tetapi tidak dapat memastikan kesesuaian penuh terhadap WCAG tanpa penilaian manual.

Untuk pemindaian satu kali tanpa menulis kode, gunakan Web Accessibility Checker online .

Dokumentasi Aksesibilitas Web

Mulai dengan ringkasan dokumentasi Web Accessibility . Lanjutkan ke Accessibility Validator untuk konfigurasi, Web Accessibility Rules untuk hierarki repositori, dan Save Validation Results untuk format laporan.

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

1. Pemeriksaan aksesibilitas apa yang dapat diotomatisasi oleh Aspose.HTML for .NET?

API dapat mengevaluasi HTML berdasarkan aturan aksesibilitas yang didukung, termasuk pemeriksaan teks alternatif, label, struktur, CSS, dan kontras warna. Cakupan yang tepat bergantung pada aturan, teknologi, dan level kesesuaian yang dipilih.

2. Apakah saya harus memvalidasi semua aturan atau memilih kumpulan aturan yang lebih kecil?

Gunakan validasi luas untuk peninjauan umum. Pilih level, teknologi, tag, kriteria, atau kode aturan tertentu jika proyek memiliki kebijakan yang ditetapkan atau memerlukan umpan balik cepat untuk komponen khusus. Kumpulan aturan yang sempit tidak boleh dianggap sebagai audit lengkap.

3. Dapatkah pemeriksaan aksesibilitas web dijalankan dalam CI/CD?

Ya. Jalankan validator selama pengujian atau pembuatan konten, ekspor hasilnya, lalu terapkan kondisi khusus proyek untuk menentukan apakah pipeline harus memberikan peringatan atau gagal. Pengujian aksesibilitas manual tetap menjadi bagian terpisah dari proses rilis.