ตัวตรวจสอบการช่วยสำหรับการเข้าถึง HTML ใน C#

ตรวจสอบการช่วยสำหรับการเข้าถึง HTML ด้วย .NET API

Aspose.HTML for .NET มี AccessibilityValidator สำหรับตรวจสอบเอกสาร HTML ตามกฎ WCAG ตรวจสอบไฟล์ในเครื่องหรือเว็บเพจ ระบุการตรวจสอบที่ล้มเหลวและองค์ประกอบที่ได้รับผลกระทบ แล้วส่งออกผลลัพธ์เป็นรายงาน

การตรวจสอบเป็นประจำช่วยให้ทีมพัฒนาพบปัญหาก่อนเผยแพร่และใช้การตรวจสอบเดิมทุกครั้งที่เนื้อหา HTML เปลี่ยนแปลง

ตรวจสอบเอกสาร HTML ใน C#

สร้างตัวตรวจสอบด้วยการตั้งค่ากฎทั้งหมด ตรวจสอบเอกสาร และวนซ้ำเฉพาะผลที่ล้มเหลว อ่าน ruleResult.Results เพื่อรายงานทุกเทคนิคที่ล้มเหลวแม้คอลเล็กชัน Errors แยกต่างหากจะว่างเปล่า

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

วิธีตรวจสอบการช่วยสำหรับการเข้าถึง HTML

1. สร้างออบเจ็กต์ WebAccessibility เพื่อเข้าถึงการสร้างตัวตรวจสอบและที่เก็บกฎ
2. เรียก CreateValidator(ValidationBuilder.All) เพื่อสร้างตัวตรวจสอบสำหรับกฎทั้งหมดที่ตรงกับการตั้งค่า builder
3. โหลดไฟล์หรือ URL ลงใน HTMLDocument
4. เรียก Validate() และเก็บ ValidationResult ที่ส่งคืน
5. วนซ้ำ Details เก็บออบเจ็กต์ RuleValidationResult ที่ล้มเหลว และตรวจสอบเทคนิคใน Results แสดงรายละเอียดข้อผิดพลาดและองค์ประกอบ HTML เมื่อมีข้อมูล

กำหนดค่าและประมวลผลการตรวจสอบการช่วยสำหรับการเข้าถึง

• การตรวจสอบทั้งหมด ValidationBuilder.All ใช้การตั้งค่าระดับและเทคโนโลยีทั้งหมดกับกฎในที่เก็บ
• การตรวจสอบแบบกรอง จำกัดขอบเขตตามระดับ เทคโนโลยี แท็ก HTML หลักการ แนวทาง เกณฑ์ หรือรายการกฎได้
• การวินิจฉัยโดยละเอียด ValidationResult.Details ให้ผลของกฎ ส่วนข้อผิดพลาดของเทคนิคให้ข้อความและเป้าหมายที่เกี่ยวข้อง
• HTML ในเครื่องและระยะไกล HTMLDocument โหลดไฟล์ HTML หรือ URL ของเว็บเพจก่อนตรวจสอบได้
• ส่งออกผลลัพธ์ได้ ประมวลผลรายงานในโค้ดหรือบันทึกเป็นข้อความ JSON หรือ XML ได้
• การตรวจสอบด้วยตนเอง ควรใช้ผลอัตโนมัติร่วมกับการทดสอบแป้นพิมพ์ เทคโนโลยีสิ่งอำนวยความสะดวก เนื้อหา และการใช้งาน

หากต้องการตรวจสอบโดยไม่เขียนโค้ด ให้ใช้ Web Accessibility Checker ออนไลน์ ใช้ .NET API เมื่อต้องกำหนดค่า ทำซ้ำ หรือผสานการตรวจสอบกับไปป์ไลน์

เอกสารตัวตรวจสอบการช่วยสำหรับการเข้าถึง

คู่มือ Accessibility Validator อธิบายโอเวอร์โหลด CreateValidator() และตัวกรอง ValidationBuilder ดู Errors and Warnings สำหรับประมวลผลเทคนิคและองค์ประกอบที่ล้มเหลว หรือ Save Validation Results สำหรับส่งออกรายงาน

ติดตั้ง Aspose.HTML for .NET

ติดตั้ง Aspose.HTML for .NET จาก NuGet ด้วย .NET CLI:

dotnet add package Aspose.HTML

คุณยังสามารถใช้หน้าต่าง NuGet Package Manager หรือเรียกใช้ Install-Package Aspose.HTML ใน Package Manager Console ได้ ดูรายละเอียดการตั้งค่าใน คู่มือการติดตั้ง หรือขอ ใบอนุญาตชั่วคราว เพื่อประเมิน API โดยไม่มีข้อจำกัดของเวอร์ชันทดลอง

คำถามที่พบบ่อยเกี่ยวกับตัวตรวจสอบการช่วยสำหรับการเข้าถึง HTML

1. จะตรวจสอบการช่วยสำหรับการเข้าถึง HTML ใน C# ได้อย่างไร

โหลดไฟล์ HTML หรือ URL ด้วย HTMLDocument สร้าง AccessibilityValidator จาก WebAccessibility แล้วเรียก Validate() ค่า ValidationResult ที่ส่งคืนมีสถานะและผลโดยละเอียด

2. ตัวตรวจสอบอัตโนมัติรับประกันความสอดคล้องกับ WCAG ได้หรือไม่

ไม่ได้ การตรวจสอบอัตโนมัติพบข้อผิดพลาดที่เครื่องทดสอบได้ แต่หลายข้อกำหนดขึ้นอยู่กับบริบทและการตัดสินของมนุษย์ จึงยังต้องทดสอบแป้นพิมพ์ เทคโนโลยีสิ่งอำนวยความสะดวก และความหมายของเนื้อหาด้วยตนเอง

3. ตรวจสอบทั้งไฟล์ HTML ในเครื่องและเว็บเพจได้หรือไม่

ได้ HTMLDocument โหลดไฟล์ในเครื่องหรือ URL ได้ การตรวจสอบระยะไกลขึ้นอยู่กับเครือข่ายและการเข้าถึงสไตล์ชีต สคริปต์ และทรัพยากรที่จำเป็น

4. ตรวจสอบเฉพาะกฎหรือระดับ WCAG ที่เลือกได้หรือไม่

ได้ ใช้ ValidationBuilder กรองตามระดับหรือเทคโนโลยี หรือสร้างตัวตรวจสอบด้วยหลักการ แนวทาง เกณฑ์ หรือรายการกฎ เหมาะเมื่อไปป์ไลน์ต้องใช้นโยบายเฉพาะ

5. บันทึกผลการตรวจสอบการช่วยสำหรับการเข้าถึงได้หรือไม่

ได้ ใช้ SaveToString() สำหรับข้อความ หรือใช้ SaveTo() กับ ValidationResultSaveFormat เพื่อเขียนข้อความ JSON หรือ XML เอาต์พุตแบบมีโครงสร้างนำไปเก็บหรือใช้ในรายงานได้