aria-labelの使用例:使うべき場面と20の修正例

ARIAラベルの使用例

aria-labelの使用例:修正前後の20例 | We.Inc

aria-label、aria-labelledby、aria-describedby、表示テキストのどれを使うべきかを、修正前後のコード20例、よくある間違い、アクセシブルネームのチェッカーで解説します。

aria-labelは、アイコンだけのボタンのように要素を名前付ける表示テキストがない場合にのみ使います:<button aria-label="Close dialog">。表示テキストがすでに名前になっているなら、それを使うか、aria-labelledbyでそのテキストを参照します。aria-describedbyは名前の後に読み上げられる補足説明を追加します。ネイティブHTMLのラベルが常に最優先です。

どの名前付け手段を使うか

  • 状況
  • 使うもの
  • 要素の中に表示テキストがある
  • 追加不要、テキストがそのまま名前になる
  • 表示されたキャプションのあるフォームフィールド
  • <label for>
  • 名前が画面上の別の場所にすでに表示されている
  • aria-labelledby="id"
  • 表示テキストがまったくない(アイコンのみ)
  • aria-label="..."
  • 名前の後に補足のヒントやエラーを付ける
  • aria-describedby="id"

ボタン、リンク、フィールド、ランドマークにはすべてアクセシブルネームが必要です。これはフォーカスが当たったときに支援技術が読み上げる短いフレーズです。このページでは名前がどのように決まるか、問題のある20のパターンと修正版の比較、そして貼り付けたコードを読み取って得られる名前を表示するチェッカーを紹介します。

  • 判断表を読み、表示テキスト、label要素、aria-labelledby、aria-labelのどれを使うかを決めます。
  • 修正前後の20のコード例から自分のパターンを探し、修正版をコピーします。
  • 自分のマークアップを名前チェッカーに貼り付け、最初のインタラクティブ要素の簡易的なアクセシブルネームを確認します。
  • ページ下部のテストチェックリストを使い、実際のスクリーンリーダーで結果を確認します。
  • ラベルは画面に見えている言葉から始めます。音声操作のユーザーは画面上の文字を話すので、Searchと表示されたボタンの名前はSearchで始まる必要があります。
  • 名前は短くし、ロールを表す語は入れません。Close ボタンという名前のボタンはロールが二重に読み上げられます。
  • ロールのない単なるdivやspan要素ではaria-labelは無視されます。実際のコントロールやランドマークに付けてください。
  • 翻訳ツールは属性値を飛ばすことが多いため、aria-labelledbyで参照する表示テキストの方がaria-labelよりページ翻訳後も残りやすくなります。

よくある質問

aria-labelとaria-labelledbyの違いは何ですか?

aria-labelは属性の中に名前を文字列として持ちます。aria-labelledbyは1つ以上の要素のidを参照し、そのテキストから名前を組み立てるため、名前は常に晴眼者が見ている内容と一致します。両方ある場合はaria-labelledbyが優先されます。

aria-labelはボタンの表示テキストを置き換えますか?

はい。ほとんどのコントロールではaria-labelの値がテキスト内容より優先されます。Buyと表示されているボタンにaria-label="Add to basket"があれば、Add to basket(カゴに追加)と読み上げられます。この不一致は音声操作のユーザーを混乱させ、WCAG 2.5.3 Label in Name(名前にラベルを含める)に違反します。

aria-describedbyはいつ使うべきですか?

名前ではない補足情報に使います。パスワードのルール、入力形式のヒント、エラーメッセージなどです。スクリーンリーダーは通常、名前とロールの後に、多くの場合少し間を置いて説明を読み上げます。説明の読み上げをオフにしているユーザーもいます。

divにaria-labelを付けられますか?

role="region"やrole="dialog"のように名前付けが許可されたロールがある場合のみ可能です。汎用のdivやspanではARIAが名前付けを禁止しており、ほとんどのスクリーンリーダーはこの属性を無視します。

画像にaria-labelは必要ですか?

いいえ。画像の名前はalt属性から取られます。装飾画像にはalt=""を使うと読み飛ばされます。imgにaria-labelを付けても動作しますが、altでできないことは何も増えません。

ARIAの第一ルール

  • ARIAの使い方に関するW3Cのガイダンスは、1つのルールから始まります。必要な意味と動作をすでに持つネイティブHTML要素があるなら、別の要素にARIAを追加するのではなく、その要素を使うことです。本物のテキストを持つ本物のボタンにはARIAはまったく不要です。
  • ARIAが変えるのは支援技術に伝わる情報だけです。キーボード操作、フォーカス、クリック処理は追加されないため、role="button"を付けたdivには、button要素なら最初から備わっているtabindexとキー処理が別途必要です。

ブラウザーが名前を決める仕組み

  • Accessible Name and Description Computationの仕様は順序を定めています。最初にaria-labelledby、次にaria-label、次にlabel要素、altテキスト、ボタンやリンク内のテキストなどのネイティブな情報源、そして最後の手段としてtitle属性です。
  • 最初に見つかった情報源が採用されるため、不要なaria-labelがあると、適切な表示ラベルが気づかないうちに隠れてしまいます。名前がおかしく聞こえるときは、テキストを編集する前に優先度の高い属性を確認してください。

名前、説明、読み上げ

  • スクリーンリーダーは通常、名前、ロール、押された状態や展開された状態などのステート、説明の順に読み上げます。正確な言い回しや順序は製品、バージョン、詳細度の設定によって異なるため、このページの読み上げ例はおおよそのものです。

aria-label、aria-labelledby、aria-describedby、表示テキストの使い分け

このリストを上から順に確認し、当てはまる最初の選択肢で止めます。表示テキストが最初なのは、1つの文字列で晴眼者、スクリーンリーダー、音声操作のユーザーすべてに対応できるからです。

要素に名前や説明を与える4つの方法

  • 選択肢
  • 役割
  • 使う場面
  • 注意点
  • 表示テキストまたは<label>
  • コンテンツやlabel要素からのネイティブな名前
  • ボタン、リンク、フィールドではほぼ常に
  • プレースホルダーはラベルではない
  • idで他の要素を参照して名前を組み立てる
  • 画面上の見出しやキャプションがすでにその要素を名前付けている
  • 参照するidが存在し、一意である必要がある
  • 名前を文字列で設定し、コンテンツより優先させる
  • アイコンボタンのように表示テキストがない
  • 汎用の要素では無視される。翻訳されないことが多い
  • 名前の後に読み上げられる説明を追加する
  • ヒント、入力形式のルール、エラーメッセージ
  • 名前ではない。説明をオフにしているユーザーには読まれないことがある

修正前後の20のコード例

各例は問題のあるパターン、修正、修正後にスクリーンリーダーがおおよそ読み上げる内容を示します。読み上げは製品や設定によって異なります。

アイコンだけの閉じるボタン

名前がないと、ボタンは通常ボタンとしか読み上げられません。図形が名前のない画像として読まれないよう非表示にします。修正後、スクリーンリーダーでは通常、閉じる、ボタンと読み上げられます。

SNSプロフィールへのアイコンリンク

空のリンクはURLとして読まれることが多く、環境によっては1文字ずつ読まれます。修正後、スクリーンリーダーでは通常、Instagramのショップ、リンクと読み上げられます。

aria-labelの代わりにアイコンと非表示テキスト

視覚的に隠したspan内の実テキストは、属性値を飛ばしがちな翻訳ツールでも残ります。修正後、スクリーンリーダーでは通常、カート、3点、リンクと読み上げられます。

2つのナビゲーションランドマーク

名前のないnav要素が2つあると、ランドマーク一覧にナビゲーションが2回表示され、区別できません。修正後、スクリーンリーダーでは通常、メイン、ナビゲーションと読み上げられます。

プレースホルダーだけの検索フィールド

プレースホルダーのテキストは代替の名前としては弱く、入力を始めると消えてしまいます。修正後、スクリーンリーダーでは通常、商品を検索、検索、編集テキストと読み上げられます。

表示ラベルのあるフォームフィールド

本物のlabel要素を使うとキャプションもクリックできるようになり、操作対象が広がります。修正後、スクリーンリーダーでは通常、メール、編集テキストと読み上げられます。

aria-describedbyによるヒントとエラー

説明はidを並べた順に連結されます。修正後、スクリーンリーダーでは通常、パスワード、セキュア編集テキスト、無効な入力、12文字以上、短すぎます...と読み上げられます。

ラジオボタンのグループ

legendがグループを名前付けるため、各選択肢が単独でも意味を持ちます。修正後、スクリーンリーダーでは通常、配送速度、グループ、通常、ラジオボタン、2個中1個目と読み上げられます。

見出しで名前付けたモーダルダイアログ

表示されている見出しを参照すると、読み上げと表示のタイトルが一致します。本当のモーダルにするにはshowModal()で開きます。修正後、スクリーンリーダーでは通常、プロジェクトを削除しますか?、ダイアログ、14ページすべてが削除されます。と読み上げられます。

aria-pressedを使ったトグルボタン

名前は固定し、状態だけを変えます。ラベルをUnboldに切り替えることはしません。修正後、スクリーンリーダーでは通常、太字、トグルボタン、押されていますと読み上げられます。

アイコンのトグル:ミュート

ラベルと押された状態を同時に変えると二重否定のように聞こえます。修正後、スクリーンリーダーでは通常、ミュート、トグルボタン、押されていませんと読み上げられます。

aria-expandedを使ったメニューボタン

スクリプトでaria-expandedとhidden属性を同時に切り替える必要があります。修正後、スクリーンリーダーでは通常、商品、ボタン、折りたたみと読み上げられます。

ハンバーガーメニューのボタン

クリックできるdivはフォーカスできず、コントロールとして読み上げられることもありません。修正後、スクリーンリーダーでは通常、メニュー、ボタン、折りたたみと読み上げられます。

情報を伝える画像と装飾画像

画像が読み手に伝える内容を書きます。空のaltは装飾を示し、読み飛ばされます。修正後、スクリーンリーダーでは通常、5月に週40件から65件に増えた売上、画像と読み上げられます。

単独で情報を伝えるSVG

role=imgを付けると、SVGは図形のツリーではなく1つのオブジェクトになります。修正後、スクリーンリーダーでは通常、Northgate Bakery、画像と読み上げられます。

キャプション付きのデータテーブル

表示されたcaptionが全員に向けてテーブルを名前付けます。タイトルがテーブルの外にある場合のみaria-labelledbyを使います。修正後、スクリーンリーダーでは通常、営業時間、テーブル、2列、8行と読み上げられます。

ライブリージョンのステータスメッセージ

テキストが変わる前にリージョンが存在していないと、多くのスクリーンリーダーは更新を読み逃します。修正後、スクリーンリーダーでは通常、保存しました(フォーカスを移動せずに読み上げ)となります。

カルーセルの名前付きリージョン

aria-roledescriptionは読み上げられるロールを変えます。控えめに使い、汎用要素には決して使いません。修正後、スクリーンリーダーでは通常、お客様の写真、カルーセルと読み上げられます。

繰り返されるRead moreリンク

固有のリンクテキストは、リンク一覧を流し読みするすべての人に役立ちます。表示されている言葉から始めるとLabel in Nameを守れます。修正後、スクリーンリーダーでは通常、冬季営業時間についてもっと読む、リンクと読み上げられます。

表示テキストと一致しないラベル

音声操作でclick Sendと話した人がこのボタンを押せる必要があるため、表示されている言葉を名前に含めます。修正後、スクリーンリーダーでは通常、送信、ボタンと読み上げられます。

よくある間違い

監査で見つかる間違いと修正方法

  • 間違い
  • 問題点
  • 修正
  • ロールのないdivやspanに付けたaria-label
  • 禁止されているため、ほとんどのスクリーンリーダーは何も読まない
  • button、リンク、ランドマークを使うか、適切なロールを付ける
  • 表示されている言葉と異なるaria-label
  • 音声操作のコマンドが届かない
  • 名前を表示テキストから始める
  • Search ボタンのように名前にロールの語を含める
  • ロールが2回読み上げられる
  • Searchと名付ける
  • フォーカス可能な要素にaria-hidden="true"
  • フォーカスが何も読まれない要素に当たる
  • 削除するか、その要素もフォーカス不可にする
  • 存在しないidを参照するaria-labelledby
  • 名前が代替に切り替わるか空になる
  • テンプレートを変更するたびにidを確認する
  • 一覧のすべてのDeleteボタンに同じラベル
  • どの行に対する操作か区別できない
  • Delete invoice 1042とするか、行タイトルをaria-labelledbyで参照する
  • titleだけを名前にしている
  • タッチ操作やキーボードのユーザーには当てにならない
  • 表示テキストまたはaria-label

テストチェックリスト

公開前に名前を確認する

  • 確認項目
  • 方法
  • すべてのコントロールに名前がある
  • ブラウザーの開発者ツールのアクセシビリティパネルで算出された名前を確認
  • 名前が表示内容と一致する
  • 表示ラベルを読み、算出された名前と比較
  • ランドマークを区別できる
  • スクリーンリーダーのローターや要素一覧でランドマーク一覧を開く
  • 状態が更新される
  • メニューやボタンを切り替え、expandedやpressedが読まれるか聞く
  • ライブメッセージが聞こえる
  • フォーカスを移動せずに保存やエラーを発生させる
  • 実際のスクリーンリーダーで確認
  • WindowsではNVDAまたはJAWSとFirefoxまたはChrome、MacとiPhoneではVoiceOverとSafari、AndroidではTalkBack

アクセシブルネームのチェッカー(簡易版)

コードを貼り付けてください。チェッカーはスクリプトを一切実行せずにブラウザー内で解析し、最初のインタラクティブ要素または名前付き要素を見つけ、公式の順序を簡略化した方法で名前を算出します。仕様の手順をいくつか省略しているため、簡単なヒントとして扱い、開発者ツールやスクリーンリーダーで確認してください。

アイコンボタン

修正済みアイコンボタン

ラベル付きフィールド

一致しないラベル

labelledbyのダイアログ

HTMLコード

コード内にボタン、リンク、フィールド、ランドマーク、画像、テーブルが見つかりません。

要素

算出された名前

(空)

名前の取得元

警告

この簡易チェックでは見つかりませんでした。

label要素

テキスト内容

SVGのtitle

title(弱い代替)

プレースホルダー(弱い代替)

aria-labelledbyが存在しないid "{id}" を参照しています。

ロールのないdivやspanのaria-labelは、ほとんどのスクリーンリーダーで無視されます。

画像にalt属性がありません。

プレースホルダーだけが名前になっています。ラベルを追加してください。

アクセシブルネームが見つかりません。

表示テキスト "{visible}" が名前の先頭にありません(WCAG 2.5.3 Label in Name)。

名前がロールを表す語で終わっているため、ロールが2回読み上げられます。

要素自体がaria-hiddenになっています。

無料トライアルを始める · 7日間の無料トライアル、本日$0

関連: ガイド|Webマーケティングと集客を学ぶ

製品

ご利用いただける方

機能

リソース

会社情報

サイトマップを見る