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 で実行できますか？

はい。テストまたはコンテンツのビルド時にバリデーターを実行し、結果を出力して、プロジェクト固有の条件に基づいて警告または失敗を判断できます。手動のアクセシビリティテストは、リリース工程の別の作業として必要です。