ARIA属性は有効な値に準拠する必要があります

ルールID: aria-valid-attr-value
ルールセット: axe-core 4.10
ユーザーへの影響:
ガイドライン: WCAG 2.1 (A), WCAG 2.0 (A), WCAG 2.2 (A), EN 301 549

Accessibility testing for dev teams - No experience required

Find and fix up to 80% of accessibility issues with axe DevTools Pro. Get started with your free trial today. No credit card needed.

Compliance Data & Impact

User Impact


Minor
Critical

Disabilities Affected

  • 盲目
  • 盲ろう者
  • 運動・器用さ

Standard(s)

  • WCAG 2.1 (A)
  • WCAG 2.0 (A)
  • WCAG 2.2 (A)
  • EN 301 549

WCAG 達成基準 [WCAG 2.1 (A)]

  • 4.1.2: Name, Role, Value

WCAG 達成基準 [WCAG 2.0 (A)]

  • 4.1.2: Name, Role, Value

WCAG 達成基準 [WCAG 2.2 (A)]

  • 4.1.2: Name, Role, Value

EN 301 549 指南

  • 9.4.1.2: Name, Role, Value

修正方法

各属性内の値が正しく入力され、有効な値に対応していることを確認する。

たとえば、 aria-hidden="true" は合格しますが、 aria-hidden="rtue" は不合格になります、 aria-hidden="pizza"

別の例として、 checkbox ロールには、 truefalse、または mixedの3つの値のみが可能です。これら3つの値以外の値を使用すると、チェックボックスが機能しなくなります。

注意:

ARIA属性の値を指定する場合は、状態とプロパティの区別、ロールの継承、未定義値、デフォルト値などの要素が混乱を招く可能性があるため、特に注意する必要があります。

値の種類

次の許可された状態またはプロパティ値のタイプを考慮すると便利です。

真/偽
trueまたはfalseを表す値。デフォルト値は「false」です。
3状態
trueまたはfalseを表す値。中間の「混合」値を持ちます。特に指定がない限り、デフォルト値は「false」です。
true/false/未定義
trueまたはfalseを表す値。デフォルトの「undefined」値は、状態またはプロパティが適用されないことを示します。
ID参照
同じドキュメント内の別の 要素 のIDへの参照
ID参照リスト
1つ以上のID参照のリスト。
整数
小数点以下がない数値。
任意の実数値。
string
制約がない値の型。
トークン
許可される値の限定されたセットの1つ。
トークンリスト
1つ以上のトークンのリスト。

未定義値: 状態またはプロパティで許可されている「未定義」の値は、状態またはプロパティが設定されていないことを明示的に示します。この値はトークンをサポートする状態とプロパティで使用され、"undefined" 値は許可されたトークンの1つである文字列です。また、「undefined」が「false」とは異なる意味を持つ場合に、true/false値を受け入れる一部の状態およびプロパティでも使用されます。

これらは状態とプロパティの汎用型ですが、特定の表現を定義するものではありません。これらの値がホスト言語でどのように表現され、処理されるかの詳細については、 状態およびプロパティ属性の処理 を参照してください。

ロールのデフォルト値と暗黙の値: 多くの状態とプロパティにはデフォルト値があります。場合によっては、特定のロールで使用されるデフォルト値が、通常のデフォルトと異なることがあります。状態またはプロパティに非標準のデフォルト値を要求するロールは、「ロールの暗黙的な値」でこれを示します。これは、「新しいデフォルト値は状態またはプロパティ名」という形式で表現されます。これを定義するロールは、作成者が明示的な値を指定しない場合、状態またはプロパティの新しいデフォルト値を持ちます。

状態とプロパティ値のリファレンス: 許可される値の詳細については、 W3C WAI-ARIA 1.1のサポートする状態とプロパティの各属性の特性表を参照してください

なぜ重要なのか

ARIA属性 (つまり、 aria- で始まるもの) には有効な値が含まれている必要があります。これらの値は正しく綴られている必要があり、特定の属性が意図したアクセシビリティ機能を実行するのに適した値に対応している必要があります。

多くのARIA属性は特定の値のセットを受け入れます。許可された値、許容される「未定義」値、および許容される「デフォルト」値が必要です。許可された値に準拠しないと、支援技術ユーザーがコンテンツにアクセスできなくなります。

ルールの説明

aria- 始まるARIA属性には有効な値が含まれている必要があります。意図したアクセシビリティ機能を実行するには、これらの値を正しく入力し、特定の属性に適した値に対応している必要があります。

仕組みについて (簡単に言うと)

WAI-ARIA属性を含むすべての要素をチェックし、属性の値が有効であることを確認します。

リソース

axe 4.10 ルールの一覧 を参照する

この情報は役に立ちましたか?

すでにフィードバックをいただきました、ありがとうございます。.

あなたの回答は次のとおりです。

この情報は役に立ちましたか?
フィードバックが提出された日付/時刻: