aria-controls ID がありません
Silktide はページ上のすべての aria-controls 属性をチェックし、そこに指定されている要素 ID が実際に存在することを確認します。この属性は、タブが表示するパネルやボタンが開くメニューなど、コントロールが操作するページの部分を示します。
<!-- 問題: ページ上に id="filter-panel" を持つ要素がありません -->
<button aria-expanded="false" aria-controls="filter-panel">フィルター</button>
これが重要な理由
の aria-controls 属性により、はコントロールとそのコントロールが影響を与えるコンテンツを関連付けることができます。一部のでは、操作対象の要素へ直接移動するためのショートカットが提供されています。参照が壊れていると、この関係は気付かないうちに失われます。参照の破損は通常、ID の名前が変更されたかコンポーネントが削除されたことを意味するため、ウィジェット自体が意図どおりに動作しなくなっている可能性を早期に警告するものでもあります。
修正方法
aria-controlsに指定されている各 ID を、同じページ内にある実際の要素のidと一致させます。この属性にはスペースで区切って複数の ID を指定できるため、それぞれを確認してください。- 操作対象の要素が動的に追加される場合は、最初から非表示でレンダリングするか、その要素が存在してから
aria-controlsを設定してください。 - 操作対象の要素が完全に不要になった場合は、この属性を削除してください。
Silktide でのテスト方法
- ページ上で
aria-controls属性を持つすべての要素を検出します。 - その要素が参照する各 ID を、ページ内に存在する要素 ID と照合します。
- どの要素とも一致しない参照をそれぞれ報告します。
トラブルシューティング
対象が後からスクリプトによって作成される
Silktide はページの読み込み時にテストを実行します。参照先のパネルがユーザー操作後にのみ表示される場合、それまでは参照が壊れています。参照が常に解決されるよう、対象をページ内に(非表示で)保持することを推奨します。