本文へスキップ
ui.design

Accessibility

画像altを情報の役割に合わせて書く

altは画像の説明文ではなく、その場で画像が果たしている役割の代替テキストです。装飾なら空、情報なら意味、リンクなら遷移先を伝えます。

ui.design: image-altui.design: axe-image-alt

まず確認する症状

  • 意味のある画像にaltがない。
  • 装飾画像に冗長な説明が入り、読み上げが長くなる。

なぜ問題か

  • 画像情報に依存した説明は、支援技術利用者へ伝わりません。
  • スクリーンショットや図解の意味がHTML本文にないと、AIや検索にも参照されにくくなります。

診断で見る指標

img altの有無
リンク画像の代替目的
本文中の画像説明
装飾画像の扱い

修正方法

最小修正

情報画像にaltを付ける

画像が伝える判断材料を短く書きます。装飾画像は空altにします。

推奨修正

複雑な図は本文でも説明する

スコア表やスクリーンショットの要点は、画像外のテキストにも置きます。

さらに改善

画像生成時のルールにする

CMSやコンポーネントでalt必須/装飾指定を分けます。

受け入れ条件

  1. 01PCとスマホの両方で目視確認し、主なCTAまたは操作対象が迷わず見つかる。
  2. 02キーボード操作、読み上げ補助、または自動検査で再発しやすい項目を確認する。
  3. 03修正後にui.designで再スキャンし、同じ所見が残る場合は原因を分解する。

コーディングエージェント向け修正指示

目的: 意味のある画像に役割ベースのaltを追加し、装飾画像は空altにしてください。スクリーンショットの重要情報は近くの本文にも要約してください。

参考資料

よくある失敗

  • すべての画像にファイル名やSEOキーワードだけを入れる。
  • 見た目だけを整え、見出し、リンク、フォームラベルなどの意味構造を直さない。
  • 1つの指摘だけを直し、同じ原因から出た別画面の再発を確認しない。

関連ページ