C# 웹 접근성 API

.NET API로 웹 접근성 검사

Aspose.HTML for .NET 은 HTML 파일과 웹페이지의 접근성을 검사하는 API를 제공합니다. Aspose.Html.Accessibility 네임스페이스를 사용하여 전체 검사를 실행하거나 이미지 대체 텍스트 누락, 불충분한 색상 대비 같은 특정 문제에 대한 규칙을 선택할 수 있습니다.

접근 가능한 HTML은 스크린 리더, 키보드 탐색, 화면 확대 및 기타 보조 기술을 사용하는 사람이 웹 콘텐츠를 이용하는 데 도움이 됩니다. 정기적인 접근성 검사를 통해 문제를 조기에 발견하고 콘텐츠가 변경되어도 WCAG에 부합하는 페이지를 유지할 수 있습니다.

웹 접근성 워크플로 선택

WCAG 레벨 A 및 AA에 따라 HTML 검사

이 예제는 WCAG 레벨 A 및 AA 기준을 선택하고 HTML과 CSS 기술에 대한 규칙을 활성화합니다. 문서를 검사하고 발견된 오류와 경고를 내보냅니다.

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

접근성 검사 워크플로 구축

1. 사용 가능한 모든 검사, 선택한 레벨과 기술, WCAG 계층 개체 또는 명시적인 규칙 목록 중에서 검사 범위를 선택합니다.
2. WebAccessibility 개체를 만들고 AccessibilityValidator 를 구성합니다.
3. 로컬 파일 또는 웹페이지 URL을 HTMLDocument 에 로드합니다.
4. Validate()를 호출하고 반환된 ValidationResult 를 처리합니다.
5. 자동으로 발견된 문제를 기록하고 소스를 수정한 다음 필요한 수동 접근성 테스트로 워크플로를 완료합니다.

웹 접근성 API 기능

• 구성 가능한 검사. 저장소의 모든 규칙을 사용하거나 적합성 레벨, 기술, HTML 태그, 원칙, 지침, 성공 기준 또는 규칙 코드별로 검사를 필터링할 수 있습니다.
• 특정 항목 검사. 대체 텍스트, 레이블, 문서 구조, 색상 대비 및 기타 지원되는 요구 사항에 맞춘 워크플로를 구축할 수 있습니다.
• 상세 결과. 규칙과 기법의 결과, 오류 유형, 메시지 및 발견된 문제와 관련된 HTML 또는 CSS 대상을 확인할 수 있습니다.
• 보고서 내보내기. 검토, 로그 및 자동화된 품질 프로세스를 위해 검사 결과를 텍스트, JSON 또는 XML로 저장할 수 있습니다.
• 애플리케이션 통합. 콘텐츠 처리, CMS 검사, 테스트 또는 CI/CD 파이프라인에서 동일한 정책을 반복 실행할 수 있습니다.
• 명확한 한계. 자동 검사는 접근성 개선을 지원하지만 수동 평가 없이 완전한 WCAG 적합성을 보장할 수는 없습니다.

코드를 작성하지 않고 한 번만 검사하려면 온라인 Web Accessibility Checker 를 사용하세요.

웹 접근성 문서

먼저 Web Accessibility 문서 개요를 확인하세요. 구성 방법은 Accessibility Validator , 저장소 계층은 Web Accessibility Rules , 보고서 형식은 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를 테스트하려면 임시 라이선스 를 요청할 수 있습니다.

웹 접근성 API FAQ

1. Aspose.HTML for .NET으로 어떤 접근성 검사를 자동화할 수 있나요?

API는 대체 텍스트, 레이블, 구조, CSS, 색상 대비 등 지원되는 접근성 규칙에 따라 HTML을 평가할 수 있습니다. 정확한 검사 범위는 선택한 규칙, 기술 및 적합성 레벨에 따라 달라집니다.

2. 모든 규칙을 검사해야 하나요, 아니면 일부 규칙만 선택해야 하나요?

일반적인 검토에는 포괄적인 검사를 사용하세요. 프로젝트에 정의된 정책이 있거나 특정 구성 요소에 대한 빠른 피드백이 필요한 경우 레벨, 기술, 태그, 기준 또는 개별 규칙 코드를 선택합니다. 제한된 규칙 집합을 완전한 감사로 간주해서는 안 됩니다.

3. CI/CD에서 웹 접근성 검사를 실행할 수 있나요?

예. 테스트 또는 콘텐츠 빌드 중에 검사기를 실행하고 결과를 내보낸 다음 프로젝트별 조건에 따라 파이프라인에서 경고하거나 실패하도록 설정할 수 있습니다. 수동 접근성 테스트는 릴리스 과정에서 별도로 수행해야 합니다.