コンテンツにスキップ
開発ガイドライン
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

画像・メディアのアクセシビリティ

alt 属性、figure 要素、アイコンボタン、色とコントラスト、アニメーションと動画、インライン SVG のアクセシビリティ対応

alt 属性

画像に適切な alt 属性を設定することで、視覚障害者を含むすべてのユーザーが情報へアクセスしやすくなります。
img 要素には必ず alt 属性を付与してください。

基本原則

  • 意味のある画像: 画像の内容や目的を簡潔に説明する
  • テキストを含む画像: 画像内の文言をそのまま記述する
  • 装飾画像・前後のテキストで説明済みの画像: 空の alt 属性(alt="")を設定する
<!-- ✅ 良い例 -->
<img
  src="/images/figure-sales.webp"
  alt="2024 年の売上推移グラフ。前年比 120% に成長"
  width="600"
  height="400"
/>

<!-- ✅ 装飾画像 -->
<img src="/images/bg-decoration.webp" alt="" width="100" height="50" />

<!-- ❌ 悪い例 -->
<img src="/images/figure-sales.webp" alt="グラフ" />

画像の種類ごとの書き方

情報を伝える画像

<!-- 具体的で有用な情報を提供 -->
<img
  src="/images/img-weather.webp"
  alt="明日の天気は晴れ、最高気温 25 度、最低気温 18 度"
  width="400"
  height="300"
/>

テキストを含む画像

<!-- 画像内の文言をそのまま記述 -->
<img
  src="/images/banner-sale.webp"
  alt="新商品発売!50% オフセール開催中"
  width="400"
  height="200"
/>

複雑な画像(グラフ・図表)

alt には要点だけを書き、すべてのデータは本文や表、figcaption で示します。

<!-- 要点を alt に記述し、詳細は表で補足 -->
<img
  src="/images/figure-sales-quarterly.webp"
  alt="2024 年の四半期別売上の棒グラフ。Q3 が最高の 200 万円"
  width="600"
  height="400"
/>
<table>
  <!-- 四半期ごとの売上データ -->
</table>

figure 要素

キャプションが必要な画像や、補足説明が必要な複雑な画像には figure 要素と figcaption 要素を使用してください。

<figure>
  <img
    src="/images/figure-architecture.webp"
    alt="システム構成図"
    width="800"
    height="600"
  />
  <figcaption>
    新システムのアーキテクチャ概要:データベース、API サーバー、フロントエンドの 3 層構成
  </figcaption>
</figure>

アイコンのみのボタン・リンク

テキストを持たないボタンやリンクは、要素自体に aria-label で名前を付け、中のアイコン画像は alt="" にします。
aria-label にはアイコンの見た目(ハート)ではなく、操作の目的(お気に入りに追加)を記述してください。

<button type="button" aria-label="商品をお気に入りに追加">
  <img src="/images/icon-heart.svg" alt="" width="24" height="24" />
</button>

インライン SVG のアイコンも同じです。SVG 自体は aria-hidden="true" で隠し、名前は親のボタンやリンクに付けます。

<button type="button" aria-label="メニューを開く">
  <svg aria-hidden="true" width="24" height="24">
    <path d="M3 18h18v-2H3v2zm0-5h18v-2H3v2zm0-7v2h18V6H3z" />
  </svg>
</button>

<a href="/" aria-label="トップページへ戻る">
  <svg aria-hidden="true" width="24" height="24">
    <path d="M10 20v-6h4v6h5v-8h3L12 3 2 12h3v8z" />
  </svg>
</a>

色とコントラスト

コントラスト比と色の使い方の基準は、アクセシビリティに従います。画像では、次の点に注意してください。

  • 画像内のテキスト: 画像に含まれるテキストも、通常のテキストと同じコントラスト比の基準を満たす
  • グラフや図: 意味を持つ線や領域は、隣接する色と 3:1 以上のコントラスト比にし、色だけでなく形状やラベルでも区別できるようにする

アニメーション・動画

アニメーションや動画などの動くコンテンツは、ユーザーによっては情報の取得や操作の妨げになります。

アニメーション

自動で動くコンテンツの基準(一時停止の手段、prefers-reduced-motion への対応)は、アクセシビリティに従います。 GIF アニメーションは停止できないため、video 要素(MP4 / WebM)に置き換えて controls を付けることを推奨します。

<video
  src="/videos/product-360.mp4"
  aria-label="製品の 360 度回転ビュー"
  width="800"
  height="800"
  autoplay
  muted
  loop
  playsinline
  controls
></video>

動画

音声を含む動画には、track 要素などで字幕を用意してください。

<video src="/videos/introduction.mp4" width="1280" height="720" controls>
  <track kind="captions" src="/videos/introduction.ja.vtt" srclang="ja" label="日本語" />
</video>

動画の読み込み方法(poster、preload など)は読み込み最適化を参照してください。

インライン SVG

意味のあるアイコンや図形には説明を付与し、装飾目的の場合は支援技術から除外するなど、用途や目的に応じて適切に設定してください。

装飾用 SVG

<!-- aria-hidden="true" で支援技術から隠す -->
<svg aria-hidden="true" width="24" height="24">
  <path d="M12 2L2 7h10v10h10L12 2z" />
</svg>

意味のある SVG

aria-labelledby や aria-describedby で参照する id は、ページ内で一意にしてください。同じ SVG をページ内で繰り返し使う場合は、id に連番を付けるなどして重複を避けます。重複すると、正しい名前が読み上げられません。

単純なアイコン

<!-- role="img" と aria-label で説明 -->
<svg role="img" aria-label="検索" width="24" height="24">
  <path
    d="M15.5 14h-.79l-.28-.27A6.471 6.471 0 0 0 16 9.5 6.5 6.5 0 1 0 9.5 16c1.61 0 3.09-.59 4.23-1.57l.27.28v.79l5 4.99L20.49 19l-4.99-5zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z"
  />
</svg>

title 要素を使う場合

<svg role="img" aria-labelledby="icon-warning-title" width="24" height="24">
  <title id="icon-warning-title">警告アイコン</title>
  <path d="M1 21h22L12 2 1 21zm12-3h-2v-2h2v2zm0-4h-2v-4h2v4z" />
</svg>

詳細な説明が必要な SVG(グラフなど)

<svg
  role="img"
  aria-labelledby="chart-sales-title"
  aria-describedby="chart-sales-desc"
  width="400"
  height="300"
>
  <title id="chart-sales-title">売上推移グラフ</title>
  <desc id="chart-sales-desc">
    2024 年 1 月から 12 月までの月別売上データ。1 月の 100 万円から徐々に増加し、12 月に 300 万円でピークに達している。
  </desc>
  <!-- SVG content -->
</svg>

属性の早見表

用途 role aria-hidden aria-label / aria-labelledby title 要素
装飾用 なし true なし なし
意味のあるアイコン img なし 必須 任意
複雑な図形・グラフ img なし 必須 必須
ボタン・リンク内 なし true 親要素に設定 なし

このページは役に立ちましたか?