require-accessible-name
要素にアクセシブルな名前がなければ警告します。名前が必要かどうかはARIAロールによって異なります。
要素が非表示かどうかはアクセシビリティツリーに沿って判断し、コントロールを囲むlabelはコントロールが属するツリーの中で探します。template要素の内容は書かれた場所では描画されず、マークアップからはどこに挿入されるか分かりません。そのため、template要素の外にあるaria-hiddenやhiddenはその内容の要素を非表示にせず、外にあるlabelはその内容のコントロールに名前を与えません。その内容は祖先のアクセシブルネームにもなりません。宣言的シャドウルートは、ホストがそれを持てて shadowrootmode が open か closed のときにホストへ付きます。付いたときは、ホストを非表示にするものは内容の要素も非表示にし、ホストが内容から名前を取るときはその内容がホストの名前になります。button の中のように付かない template は何も寄与しません。付くかどうかマークアップから分からないときは、祖先を報告しません。そのシャドウルートのslotは、名前(slot属性)で割り当てられたライトDOMの子、割り当てがなければ自身の子を名前に寄与します。どのslotにも割り当てられないライトDOMの子は名前になりません。割り当てが分からないとき(シャドウルートの外のslot、フレームワークのコンポーネントのslot、手動の割り当て、ライトDOMの子にテンプレート構文があるとき)は、報告しません。
条件ブロック(Svelteの{#if}、Alpine.jsの<template x-if>、Vueのv-if・v-else-if・v-else・v-forをもつ要素)のどの分岐が描画されるかはマークアップから分からないため、いずれかの分岐にある名前は名前として扱い、その名前を分岐にもつ要素は報告しません。分岐の中にあるコンポーネントや式のような不明な内容は、ブロックの外にある場合と同じく不明として扱います。どの分岐も名前を与えないときは報告します。
値が描画されるまで分からないaria-labelledby(JSXのaria-labelledby={id})は、参照先が分からないため報告しません。同じツリーに参照先の要素がないaria-labelledbyのトークンも、idが分からない要素(<h2 id={x}>)がツリーにあるときは、それが参照先かもしれないため報告しません。
❌ 間違ったコード例
<button>
<span></span>
<span></span>
<span></span>
</button>
✅ 正しいコード例
<button>
<span class="visually-hidden">Menu</span>
<span></span>
<span></span>
<span></span>
</button>
Interface
{
"require-accessible-name": boolean
}
Options
{
"require-accessible-name": {
"options": {
"ariaVersion"?: "1.1" | "1.2" | "1.3"
}
}
}
| Property | Type | Default Value | Description |
|---|---|---|---|
ariaVersion | "1.1" | | "1.3" | 評価するWAI-ARIAのバージョンを指定します。 |
Default Severity
error