Lighthouseで画像にaltがないと指摘されたときの直し方

​​Lighthouse​HTML,アクセシビリティ,トラブルシュート

Lighthouse のアクセシビリティの監査で「Image elements do not have [alt] attributes」(日本語のレポートでは「画像要素に [alt] 属性が指定されていません」)と出たときは、alt 属性のない img 要素がページにあります。ブログの記事に入れた写真のように内容を伝える画像には、何が写っているかを alt に書きます。区切り線のような飾りの画像には alt="" を付けます。この2つで指摘は消えます。

画像を送信ボタンにした <input type="image"> は、別の監査(input-image-alt)で同じように指摘されます。こちらは alt="" では消えず、ボタンの働きを書く必要があります。

私は検証環境で、alt のない画像2つと、alt のない画像のボタン1つがあるページに Lighthouse を実行し、指摘が出ることと、直すと消えることを確かめました。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Lighthouse 13.6.0(npm で入れた CLI。中で使われている axe-core は 4.14.0)、ブラウザは Google Chrome for Testing 153 のヘッドレスです。アクセシビリティの項目だけ(--only-categories=accessibility)を、初期設定のモバイル向けの条件で実行しました。ページは手元で作り、127.0.0.1 から配信しました。Chrome の DevTools の Lighthouse パネルや PageSpeed Insights、実際のスクリーンリーダーでの読み上げは試していません。alt に書く文の良し悪しは Lighthouse では判定されないので、この記事でも扱っていません。

指摘が出るページ

検証に使ったのは、猫の写真、区切り線の画像、虫めがねの画像を使った検索ボタンを置いたページです。どれにも alt を書いていません。

html
<main>
<h1>今日の猫</h1>
<!-- 1. 内容を伝える写真に alt がない -->
<img src="cat.svg" width="240" height="160">
<p>窓辺で寝ているところです。</p>
<!-- 2. 区切り線の飾り画像に alt がない -->
<img src="line.svg" width="320" height="8">
<!-- 3. 画像の送信ボタン(input type="image")に alt がない -->
<form action="/search">
  <input type="search" name="q" aria-label="サイト内検索">
  <input type="image" src="search.svg">
</form>
</main>

このページを python3 -m http.server で配信し、次のように Lighthouse を実行しました。

bash
npx lighthouse http://127.0.0.1:8000/bad.html \
  --only-categories=accessibility \
  --output=json --output=html --output-path=./out/bad \
  --chrome-flags="--headless=new --no-sandbox" --quiet

HTML のレポートで「Image elements do not have [alt] attributes」を開くと、写真と区切り線の2つの img が「Failing Elements」に並びました。

Lighthouse のレポートで「Image elements do not have [alt] attributes」を開いた画面。猫の写真の img と、区切り線の img の2つが Failing Elements に並び、ページの中の位置が枠で示されている
直す前のページのレポート。alt のない2つの img が並ぶ

JSON のレポートから、アクセシビリティの点数と、画像に関わる監査の結果を取り出すと次のとおりです。2つの img の理由は同じなので、1つ目だけ載せています。Lighthouse のバージョンなどの行も省いています。

text
accessibility score: 85
[image-alt] weight=10 score=0 (binary)
  title: Image elements do not have `[alt]` attributes
  - body > main > img | <img src="cat.svg" width="240" height="160">
      Fix any of the following:
        Element does not have an alt attribute
        aria-label attribute does not exist or is empty
        aria-labelledby attribute does not exist, references elements that do not exist or references elements that are empty
        Element has no title attribute
        Element's default semantics were not overridden with role="none" or role="presentation"
[input-image-alt] weight=10 score=0 (binary)
  title: `<input type="image">` elements do not have `[alt]` text
  - body > main > form > input | <input type="image" src="search.svg">
      Fix any of the following:
        Element has no alt attribute
        aria-label attribute does not exist or is empty
        aria-labelledby attribute does not exist, references elements that do not exist or references elements that are empty
        Element has no title attribute
        Element does not have an implicit (wrapped) <label>
        Element does not have an explicit <label>
failed accessibility audits: image-alt, input-image-alt

「Fix any of the following」の下に並んでいるのが、合格するための方法です。どれか1つを満たせば合格します。判定は、Lighthouse が中で使っている axe-core の image-alt のルールと input-image-alt のルールで決まっています。

写真と飾りの画像と検索ボタンの直し方

次のように直しました。

html
<main>
<h1>今日の猫</h1>
<!-- 1. 写真には、何が写っているかを alt に書く -->
<img src="cat.svg" width="240" height="160" alt="窓辺で丸くなって寝ている灰色の猫">
<p>窓辺で寝ているところです。</p>
<!-- 2. 飾りの画像は alt="" にする -->
<img src="line.svg" width="320" height="8" alt="">
<!-- 3. 画像の送信ボタンには、ボタンの働きを alt に書く -->
<form action="/search">
  <input type="search" name="q" aria-label="サイト内検索">
  <input type="image" src="search.svg" alt="検索">
</form>
</main>

写真のように、画像が見えないと内容が伝わらないものには、写っているものを文で書きます。区切り線のように、なくても内容が変わらない画像は alt="" にします。MDN の img 要素のページにも、alt を空文字列にすると、その画像がコンテンツの重要な部分ではないことを示す、と書かれています。レポートの image-alt の説明にも、飾りの要素は空の alt 属性で無視させられる、とあります。

同じ条件で Lighthouse を実行し直すと、2つの監査はどちらも合格し、点数は100になりました(直す前と同じように、一部の行を省いています)。

text
accessibility score: 100
[image-alt] weight=10 score=1 (binary)
  title: Image elements have `[alt]` attributes
[input-image-alt] weight=10 score=1 (binary)
  title: `<input type="image">` elements have `[alt]` text
failed accessibility audits: (none)

Playwright の ariaSnapshot() で、ページの構造(役割と名前)も書き出しました。直す前の2つの画像は名前のない img で、検索ボタンの名前は、Playwright の計算では「Submit」になっていました。直した後は、写真に alt の文が名前として付き、区切り線の画像は一覧から消えています。ボタンの名前は「検索」になりました。

text
--- bad.html
- main:
  - heading "今日の猫" [level=1]
  - img
  - paragraph: 窓辺で寝ているところです。
  - img
  - searchbox "サイト内検索"
  - button "Submit"
--- good.html
- main:
  - heading "今日の猫" [level=1]
  - img "窓辺で丸くなって寝ている灰色の猫"
  - paragraph: 窓辺で寝ているところです。
  - searchbox "サイト内検索"
  - button "検索"

指摘が消える書き方と、消えない書き方

alt の書き方をいくつか変えたページでも試しました。結果をまとめると次のとおりです。

書き方 Lighthouse の判定
alt に「画像」とだけ書く 合格
alt を書かずに title="窓辺の猫" だけを付ける 合格
alt を書かずに role="presentation" を付ける 合格
alt を書かずに aria-hidden="true" を付ける チェックの対象外
alt=" "(半角スペースを1つ) 不合格
<input type="image"> に alt="" 不合格

alt="画像" が合格するのは、image-alt が alt 属性があるかどうかを見ていて、中身が画像の説明になっているかは見ていないためです。点数が100でも、alt の文が役に立つものかどうかは、自分で読んで確かめる必要があります。

aria-hidden="true" を付けた画像は、合格にも不合格にもなりませんでした。axe-core を直接動かして image-alt の結果を見ると、この画像だけが合格の一覧にも違反の一覧にも入っていませんでした。指摘が出ないのは、直ったからではなく、チェックから外れたためです。

半角スペースだけの alt は、空の alt とは別の扱いになり、不合格でした。理由は次のとおりです(image-alt の部分だけを載せています)。

text
[image-alt] weight=10 score=0 (binary)
  title: Image elements do not have `[alt]` attributes
  - body > main > img | <img src="line.svg" width="320" height="8" alt=" ">
      Fix all of the following:
        Element has an alt attribute containing only a space character, which is not ignored by all screen readers

スペースだけの alt は、すべてのスクリーンリーダーが無視するわけではない、という理由です。image-alt のルールでは、これは「none」(当てはまったら不合格)の条件 alt-space-value として決められています。飾りの画像は、スペースを入れずに alt="" と書きます。

<input type="image"> は、alt="" では「Element has an empty alt attribute」と出て不合格のままでした。input-image-alt のルールは、空でない alt(non-empty-alt)を求めています。送信ボタンは押すためのものなので、飾りとして扱わず、働きを書きます。

alt と同じ文がすぐ近くにあるとき

alt の書き方を変えたページには、リンクの中に画像と同じ言葉の文字を並べたもの(<a href="/notes/1"><img … alt="窓辺の猫">窓辺の猫</a>)も入れました。この画像は、「Image elements do not have [alt] attributes that are redundant text.」(image-redundant-alt)の監査で Failing Elements に出ました。

Lighthouse のレポートで「Image elements do not have [alt] attributes that are redundant text.」を開いた画面。説明の末尾に Unscored と表示され、Failing Elements に alt="窓辺の猫" の img が1つ並ぶ
alt とリンクの文字が同じ画像。Unscored の監査として出る

レポートの説明には、リンクや画像の隣の文字とまったく同じ代わりのテキストは、2回読み上げられるのでスクリーンリーダーを使う人を混乱させるおそれがある、と書かれています。ariaSnapshot() でも、このリンクの名前は「窓辺の猫窓辺の猫」になっていました。

text
  - link "窓辺の猫窓辺の猫":
    - /url: /notes/1
    - img "窓辺の猫"
    - text: 窓辺の猫

この監査には「Unscored」と表示され、Lighthouse 13.6.0 の設定でも重みは0なので、点数には入りません。

リンクの中の画像を alt="" にしたページ(<a href="/notes/1"><img … alt="">窓辺の猫</a>)で実行すると、image-redundant-alt は「該当なし」になり、アクセシビリティの点数は100でした。ariaSnapshot() でも、リンクの名前は文字の1回分になりました。

text
  - link "窓辺の猫":
    - /url: /notes/1

一方、写真のすぐ下の段落と同じ文を alt に書いた画像(alt="窓辺で寝ているところです。" の img の後に、同じ文の <p>)は、この監査に出ませんでした。axe-core の同じ文かどうかを調べるチェックの設定は、画像を囲む button、a[href]、p、li、td、th などの中の文字と比べます。画像が段落の外にあると、比べる相手になりません。

点数への影響

Lighthouse 13.6.0 の設定では、アクセシビリティの点数での重みは、image-alt と input-image-alt がどちらも10です。直す前のページは、この2つが0点になり、重みの合計135に対して得点は115で、点数は85でした。直した後は重みの合計136に対して得点も136で、100です(全体の重みが1つ増えたのは、直した後のページで presentation-role-conflict の監査が「該当なし」から計算の対象に変わったためです)。

image-alt は SEO の項目にも重み1で入っています。SEO の項目だけで同じページを実行すると、直す前は82、直した後は91でした。100にならないのは、検証のページに meta description を入れていないためです。

​Posted by 86