要約には識別可能なテキストが必要です
修正方法
正しいマークアップソリューション
summary-name
のすべてのチェックに合格する方法はいくつかあります。アクセシブルなサマリー要素を作成する最も信頼性の高い方法は、サマリー要素内にテキストを配置することです。
<details>
<summary id="text">Name</summary>
...
</details>
代替方法
サマリー要素に隠し代替テキストを指定することも可能です。これは、CSS背景画像を使用する場合など、サマリーに表示可能なテキストがない場合に使用できます。隠れた代替手段を提供する方法には次のようなものがあります。
-
aria-label="text alternative here"
属性を使用します。 -
aria-labelledby="id-to-element-with-text"
属性を使用します。 -
title="tooltip alternative here"
属性を使用します。
なぜ重要なのか
スクリーン リーダーのユーザーは、アクセス可能な名前を持たない summary
要素の目的を判別できません。これにより、コントロールの目的を理解できず、 details
要素に隠された情報を見つけられない可能性が高くなります。
ルールの説明
サマリー要素は、 details
要素を展開および折りたたむためのコントロールとして使用されます。これらの summary
要素には、コントロールの使用時に表示される情報のトピックまたは目的を明確に示す識別可能なテキストが必要です。
summary-name
ルールは、 button-name
ルールから機能を分離します。なぜなら、 summary
要素は button
要素とは異なる固有のセマンティクスを持つからです。
仕組みについて (簡単に言うと)
summary
要素のコントロールとして使用されるすべての details
要素をチェックし、識別可能でアクセス可能な名前が付けられていることを確認します。