---
title: 画像・メディアのアクセシビリティ
sidebar:
  label: アクセシビリティ
description: alt 属性、figure 要素、アイコンボタン、色とコントラスト、アニメーションと動画、インライン SVG のアクセシビリティ対応
---

## alt 属性

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

### 基本原則

- **意味のある画像**: 画像の内容や目的を簡潔に説明する
- **テキストを含む画像**: 画像内の文言をそのまま記述する
- **装飾画像・前後のテキストで説明済みの画像**: 空の alt 属性（`alt=""`）を設定する

```html
<!-- ✅ 良い例 -->
<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="グラフ" />
```

### 画像の種類ごとの書き方

#### 情報を伝える画像

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

#### テキストを含む画像

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

#### 複雑な画像（グラフ・図表）

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

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

## figure 要素

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

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

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

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

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

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

```html
<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>
```

## 色とコントラスト

コントラスト比と色の使い方の基準は、[アクセシビリティ](/frontend/quality/accessibility#色とサイズ)に従います。画像では、次の点に注意してください。

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

## アニメーション・動画

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

### アニメーション

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

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

### 動画

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

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

動画の読み込み方法（`poster`、`preload` など）は[読み込み最適化](/frontend/media/optimization#動画)を参照してください。

## インライン SVG

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

### 装飾用 SVG

```html
<!-- 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` に連番を付けるなどして重複を避けます。重複すると、正しい名前が読み上げられません。

#### 単純なアイコン

```html
<!-- 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 要素を使う場合

```html
<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（グラフなど）

```html
<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`      | 親要素に設定                 | なし       |
