Aspose.HTML for .NET Aspose.HTML for .NET
  Download   Pricing Buy

.NET API로 HTML 접근성 검사

Aspose.HTML for .NET 은 WCAG 접근성 규칙에 따라 HTML 문서를 검사하는 AccessibilityValidator 를 제공합니다. 로컬 파일이나 웹페이지를 검사하고 실패한 검사와 관련 요소를 식별한 다음 결과를 보고서로 내보낼 수 있습니다.

정기적인 검사를 통해 개발 팀은 게시 전에 접근성 문제를 발견하고 HTML 콘텐츠가 변경될 때마다 동일한 검사를 적용할 수 있습니다.


C#에서 HTML 문서 검사

사용 가능한 모든 규칙 설정으로 검사기를 만들고 문서를 검사한 다음 실패한 결과만 순회합니다. 별도의 Errors 컬렉션이 비어 있어도 실패한 모든 기법을 보고하도록 ruleResult.Results를 읽습니다.

HTML 접근성을 검사하는 C# 코드

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)을 호출하여 전체 빌더 설정과 일치하는 모든 규칙용 검사기를 만듭니다.
  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 , 보고서를 텍스트, JSON 또는 XML로 내보내려면 Save Validation Results 를 참조하세요.


Aspose.HTML for .NET 설치

.NET CLI를 사용하여 NuGet에서 Aspose.HTML for .NET 을 설치합니다.

dotnet add package Aspose.HTML

NuGet 패키지 관리자 UI를 사용하거나 패키지 관리자 콘솔에서 Install-Package Aspose.HTML을 실행할 수도 있습니다. 설정 방법은 설치 가이드 를 참조하세요. 평가 제한 없이 API를 테스트하려면 임시 라이선스 를 요청할 수 있습니다.


HTML 접근성 검사기 FAQ

1. C#에서 HTML 접근성을 어떻게 검사하나요?

HTML 파일 또는 URL을 HTMLDocument로 로드하고 WebAccessibility에서 AccessibilityValidator를 만든 다음 Validate()를 호출합니다. 반환된 ValidationResult에는 검사기가 평가한 규칙의 상태와 상세 결과가 포함됩니다.

2. 자동 접근성 검사기로 WCAG 적합성을 보장할 수 있나요?

아니요. 자동 검사는 기계적으로 판정할 수 있는 오류를 식별하지만 많은 요구 사항은 문맥과 사람의 판단에 따라 달라집니다. 키보드와 보조 기술을 사용한 테스트 및 콘텐츠 의미에 대한 수동 검토가 필요합니다.

3. 로컬 HTML 파일과 웹페이지를 모두 검사할 수 있나요?

예. HTMLDocument는 로컬 파일이나 URL을 로드할 수 있습니다. 원격 검사는 네트워크 액세스와 문서가 선택한 검사에 필요한 스타일시트, 스크립트 및 기타 리소스를 가져올 수 있는지에 따라 달라집니다.

4. 선택한 WCAG 규칙이나 레벨만 검사할 수 있나요?

예. ValidationBuilder를 사용하여 레벨이나 기술별로 필터링하거나 원칙, 지침, 성공 기준 또는 명시적인 규칙 목록으로 검사기를 만듭니다. 전체 저장소 대신 특정 정책을 파이프라인에 적용할 때 유용합니다.

5. 접근성 검사 결과를 저장할 수 있나요?

예. 텍스트 표현에는 SaveToString()을 사용하고 텍스트, JSON 또는 XML 파일을 쓰려면 ValidationResultSaveFormat과 함께 SaveTo()를 사용합니다. 구조화된 출력은 보관하거나 보고 및 품질 관리 워크플로에서 사용할 수 있습니다.

관련 웹 접근성 워크플로

WCAG 규칙 선택, 이미지 alt 속성 검사, 색상 대비 검사 또는 접근성 API 개요를 계속 살펴보세요.

WCAG 접근성 규칙
이미지 alt 속성 검사기
색상 대비 검사기
웹 접근성 API