C# で WCAG アクセシビリティルールを検証

プロジェクトに必要な WCAG ルールを選択し、C# で HTML ドキュメントを検証します。

.NET API でウェブアクセシビリティルールを選択

Aspose.HTML for .NET は、WCAG 2.0 の原則、ガイドライン、達成基準、達成方法を含む AccessibilityRules リポジトリを提供します。必要なルールをコードで選択し、AccessibilityValidator を作成して、HTML ファイルやウェブページに関連するアクセシビリティ問題を検証できます。

特定のルールを選択する方法は、プロジェクトが定義済みのアクセシビリティポリシーに従う場合や、特定の種類の問題を検証する場合に適しています。検証レポートには、失敗したチェックと確認が必要な HTML 要素が示されます。

選択した WCAG ルールで HTML を検証

この例では、画像の代替テキスト、フォームラベル、iframe のタイトル、要素 ID の一意性に関する 4 つの 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());
}

特定のアクセシビリティルールを検証する方法

WebAccessibility オブジェクトを作成し、その Rules リポジトリにアクセスします。
プロジェクトの検証ポリシーに必要な原則、ガイドライン、達成基準、達成方法のコードを定義します。
コードを GetRules() に渡し、要求したすべてのルールが返されたことを確認します。
取得した IList<IRule> から AccessibilityValidator を作成します。
HTMLDocument で HTML を読み込み、Validate() を呼び出して、返されたレポートを確認または保存します。

アクセシビリティルールの階層

原則。 WCAG の最上位カテゴリで、アクセシブルなコンテンツの基本目標を示します。
ガイドライン。 各原則には、関連するアクセシビリティ要件をまとめるガイドラインが含まれます。
達成基準。 検証可能な要件を定め、適合レベル A、AA、AAA を示します。
達成方法と失敗例。 H37 などの達成方法コードは実装チェックを示し、失敗例コードは基準に違反するパターンを示します。
コードによる選択。 GetRules() は 1 つ以上のコードを受け取り、リポジトリに存在しないコードを除外します。
対象を絞った検証。 選択したルールはプロジェクト固有のチェックに利用できますが、限定されたルール一覧だけでは完全なアクセシビリティ監査になりません。

明示的なルールコード一覧ではなく、広範なチェックやビルダーで絞り込んだチェックが必要な場合は、 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 への適合を判断するための検証可能な要件です。達成方法は基準を満たすための文書化された方法を示し、失敗例は基準を満たさないパターンを示します。1 つの達成方法を満たすだけでは適合を証明できません。

2. C# で特定の WCAG ルールだけを検証するにはどうすればよいですか？

必要なコードを AccessibilityRules.GetRules() に渡し、返された IList<IRule> で AccessibilityValidator を作成して HTMLDocument を検証します。レポートは選択したルールの範囲と適用可能なビルダー設定に限定されます。

3. GetRules() には原則、ガイドライン、達成基準、達成方法を指定できますか？

はい。これらのルール型はすべて IRule を実装しているため、そのコードを GetRules() に渡せます。目的の範囲に合う階層を選択してください。上位オブジェクトはより広いグループを含み、達成方法コードは特定のチェックを対象にします。

4. 指定したアクセシビリティルールのコードが見つからない場合はどうなりますか？

この場合、GetRules() メソッドはリポジトリに存在しないコードを結果から除外します。入力ミスや未対応コードによって検証範囲が意図せず狭くならないように、検証前に返されたコレクションと要求したコードを比較してください。

5. 選択したルールの検証で WCAG への適合を証明できますか？

いいえ。選択した自動チェックに基づいてドキュメントを評価したことだけを示します。WCAG への適合には、手動テストや人の判断が必要な要件を含め、該当する達成基準を評価する必要があります。