HTML Tag Reference

aria-roledescription 属性

ローカライズされた説明を定義する

aria-roledescription 属性は、要素の役割について人間が判読できる、ローカライズされた説明を定義します。

role="group" や role="region" のような、非インタラクティブなコンテナがもつ役割やその目的を明確にするため、あるいは、ウィジェットのより具体的な説明を提供するためにのみ、aria-roledescription 属性を使用できます。

aria-roledescription 属性を使用する場合、この属性が適用される要素が有効な ARIA ロール、もしくは暗黙のロールを持っていることに加え、aria-roledescription 属性の値が空（もしくは空白文字のみ）ではないことを確認してください。

aria-roledescription 属性の仕様

この属性を使用できる要素
  • すべての HTML 要素

aria-roledescription 属性のサンプルソース

<section class="slider" aria-roledescription="カルーセル" aria-label="サービス一覧のカルーセル">
  <div class="slide" aria-live="polite">
    <div class="slide-item" role="group" aria-roledescription="スライド">
     <img src="slide-01.png" alt="サービス01">
    </div>
    <div class="slide-item" role="group" aria-roledescription="スライド">
      <img src="slide-02.png" alt="サービス02">
    </div>
    <div class="slide-item" role="group" aria-roledescription="スライド">
      <img src="slide-03.png" alt="サービス03">
    </div>
    <div class="slide-item" role="group" aria-roledescription="スライド">
      <img src="slide-04.png" alt="サービス04">
    </div>
  </div>
</section>

用途から目的の要素を探す

用途から HTML 要素を逆引きできます。