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

.NET API로 웹 접근성 규칙 선택

Aspose.HTML for .NET 은 WCAG 2.0 원칙, 지침, 성공 기준 및 기법이 포함된 AccessibilityRules 저장소를 제공합니다. 코드로 필요한 규칙을 선택하고 AccessibilityValidator를 만든 다음 HTML 파일이나 웹페이지에서 관련 접근성 문제를 검사할 수 있습니다.

특정 규칙 선택은 프로젝트가 정의된 접근성 정책을 따르거나 한 가지 유형의 문제를 검사해야 할 때 유용합니다. 검사 보고서는 실패한 검사와 확인이 필요한 HTML 요소를 보여 줍니다.


선택한 WCAG 규칙으로 HTML 검사

이 예제는 이미지 대체 텍스트, 폼 레이블, iframe 제목 및 고유한 요소 ID를 다루는 네 가지 HTML 기법을 선택합니다. GetRules()가 반환한 일치하는 IRule 개체를 특정 항목 검사기에 전달합니다.

선택한 접근성 규칙을 검사하는 C# 코드

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

특정 접근성 규칙 검사 방법

  1. WebAccessibility 개체를 만들고 해당 Rules 저장소에 액세스합니다.
  2. 프로젝트 검사 정책에 필요한 원칙, 지침, 성공 기준 또는 기법의 코드를 정의합니다.
  3. 코드를 GetRules() 에 전달하고 요청한 모든 규칙이 반환되었는지 확인합니다.
  4. 반환된 IList<IRule>로 AccessibilityValidator 를 만듭니다.
  5. HTMLDocument 로 HTML을 로드하고 Validate()를 호출한 다음 반환된 보고서를 확인하거나 저장합니다.

접근성 규칙 계층 이해

  • 원칙. 최상위 WCAG 범주는 접근 가능한 콘텐츠의 폭넓은 목표를 설명합니다.
  • 지침. 각 원칙에는 관련 접근성 요구 사항을 구성하는 지침이 포함됩니다.
  • 성공 기준. 검사 가능한 요구 사항을 제공하고 적합성 레벨 A, AA 또는 AAA를 지정합니다.
  • 기법과 실패 사례. H37 같은 기법 코드는 구현 검사를 설명하고 실패 코드는 기준을 위반하는 패턴을 식별합니다.
  • 코드 기반 선택. GetRules()는 하나 이상의 코드를 받아 저장소에 없는 코드를 제외합니다.
  • 특정 항목 검사. 선택한 규칙은 프로젝트별 검사를 지원하지만 제한된 규칙 목록만으로는 완전한 접근성 감사가 되지 않습니다.

애플리케이션에 명시적인 규칙 코드 목록 대신 광범위한 검사나 빌더로 필터링한 검사가 필요한 경우 HTML 접근성 검사기 를 사용하세요.


WCAG 규칙 문서 및 참조

전체 저장소 계층과 GetPrinciple(), GetGuideline(), GetCriterion(), GetRules() 예제는 Web Accessibility Rules 를 참조하세요. W3C WCAG Techniques 색인에서는 개별 기법과 실패 코드의 목적 및 검사 절차를 설명합니다.


Aspose.HTML for .NET 설치

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

dotnet add package Aspose.HTML

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


웹 접근성 규칙 FAQ

1. WCAG 성공 기준과 기법의 차이는 무엇인가요?

성공 기준은 WCAG 적합성을 판단하는 검사 가능한 요구 사항입니다. 기법은 기준을 충족하는 문서화된 방법을 설명하고 실패 사례는 기준을 충족하지 못하는 패턴을 설명합니다. 하나의 기법을 통과하는 것만으로 적합성이 입증되지는 않습니다.

2. C#에서 특정 WCAG 규칙만 검사하려면 어떻게 하나요?

필요한 코드를 AccessibilityRules.GetRules()에 전달하고 반환된 IList<IRule>로 AccessibilityValidator를 만든 다음 HTMLDocument를 검사합니다. 보고서는 선택한 규칙 범위와 적용 가능한 빌더 설정으로 제한됩니다.

3. GetRules()에 원칙, 지침, 성공 기준 및 기법을 전달할 수 있나요?

예. 이러한 규칙 형식은 모두 IRule을 구현하므로 코드를 GetRules()에 전달할 수 있습니다. 목적에 맞는 계층을 선택하세요. 상위 개체에는 더 넓은 그룹이 포함되며 기법 코드는 특정 검사를 대상으로 합니다.

4. 요청한 접근성 규칙 코드를 찾을 수 없으면 어떻게 되나요?

이 경우 GetRules() 메서드는 저장소에 없는 코드를 결과에서 제외합니다. 오타나 지원되지 않는 코드로 인해 의도한 검사 범위가 줄어들지 않도록 검사 전에 반환된 컬렉션과 요청한 코드를 비교하세요.

5. 선택한 규칙을 검사하면 WCAG 적합성을 입증할 수 있나요?

아니요. 문서가 선택한 자동 검사에 따라 평가되었다는 것만 보여 줍니다. WCAG 적합성을 확인하려면 수동 테스트와 사람의 판단이 필요한 요구 사항을 포함하여 적용 가능한 성공 기준을 평가해야 합니다.

관련 웹 접근성 워크플로

전체 검사, 이미지 alt 속성 검사, 색상 대비 검사 또는 접근성 API 개요를 계속 살펴보세요.

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