---
title: 画像ファイルの命名規則
sidebar:
  label: 命名規則
description: 接頭辞ルール、ディレクトリ構成、ファイル名の構成、レスポンシブ・連番対応の命名規則
---

画像ファイルの名前は、種類を表す接頭辞で始め、英小文字の単語をハイフンでつなぎます（例: `icon-arrow-right.svg`）。
名前の付け方を統一しておくと、ファイルを探しやすくなり、担当者が替わっても迷わずに済みます。

## 接頭辞ルール

ファイル名は次の接頭辞のいずれかで始めます。  
特定の要件やデザインシステムにより別の接頭辞が必要な場合は、**プロジェクト内で定義して一貫性を保つこと**を前提に追加して構いません。

| 接頭辞 | 用途 | 例 |
| --- | --- | --- |
| `icon-` | アイコン | `icon-menu.svg` |
| `bg-` | CSS の背景画像 | `bg-pattern.webp` |
| `img-` | 写真などの一般的な画像 | `img-product.webp` |
| `figure-` | 図解・グラフなどの説明画像 | `figure-diagram.webp` |
| `banner-` | ヒーロー画像・バナー | `banner-hero.webp` |
| `text-` | 見出しなどの文字を画像にしたもの | `text-heading.webp` |
| `logo-` | ロゴ（ロゴタイプを含む） | `logo-company.svg` |

迷いやすいものは次のように分けます。

- **ロゴタイプ**: `text-` ではなく `logo-` を使う
- **装飾用の図形**: アイコンとして使わないものは `icon-` ではなく、CSS の背景なら `bg-`、それ以外は `img-` を使う
- **ヒーロー画像**: ページ上部の大きな画像は `img-` ではなく `banner-` を使う

## ディレクトリ構成の例

```text
images/
├── common/ # 共通画像
│   ├── logo-company.svg
│   ├── icon-menu.svg
│   └── bg-pattern.webp
├── pages/ # ページ固有画像
│   ├── top/
│   │   ├── banner-hero.webp
│   │   └── img-feature-01.webp
│   └── product/
│       ├── img-main.webp
│       └── img-gallery-01.webp
└── ui/ # UI 要素の画像
    ├── bg-button.webp
    └── icon-arrow-right.svg
```

`images/` を置く場所は、[開発環境テンプレート](/frontend/environment)のディレクトリ構成に従ってください（Vite テンプレートは `src/assets/`、WordPress テンプレートは `theme/src/assets/` の下）。Astro テンプレートでは、ビルド時に最適化する画像を `src/assets/` の下に置きます。

:::note[例外]
システムの制限や、サイトリニューアルなどの際にパスを変更したくない場合、既に同名のディレクトリが存在する場合などは、この限りではありません。
:::

## ファイル名の構成要素

### 基本構成

```text
[接頭辞]-[詳細]-[連番].[拡張子]
```

- `banner-hero-main.webp`: メインのヒーロー画像
- `img-product-gallery-01.webp`: 商品ギャラリーの 1 枚目
- `icon-arrow-right.svg`: 右矢印アイコン

### レスポンシブ対応時

ブレークポイントごとに別の画像（構図やトリミングが異なる画像）を用意する場合は、ブレークポイント名を付けます。

```text
[接頭辞]-[詳細]-[ブレークポイント].[拡張子]
```

- `banner-hero-desktop.webp`: PC 用ヒーロー画像
- `banner-hero-tablet.webp`: タブレット用ヒーロー画像
- `banner-hero-mobile.webp`: スマートフォン用ヒーロー画像

`srcset` 用に同じ画像を幅違いで書き出す場合は、ピクセル幅を付けます。

```text
[接頭辞]-[詳細]-[幅].[拡張子]
```

- `img-product-400.webp`、`img-product-800.webp`、`img-product-1200.webp`

### 連番使用時

原則として 2 桁でゼロ埋めします（`01`、`02`、`03`…）。100 枚以上になる可能性がある場合は 3 桁（`001`、`002`…）にします。同じ系列の中では桁数を揃えてください。

- `img-gallery-01.webp`、`img-gallery-02.webp`
- `figure-step-001.webp`、`figure-step-002.webp`

## 禁止事項

- **日本語ファイル名**: `画像.jpg` ❌
- **スペース**: `icon menu.jpg` ❌
- **アンダースコア**: `icon_menu.jpg` ❌（ハイフンを使用）
- **大文字**: `Icon-Menu.jpg` ❌
- **特殊文字**: `icon@menu.jpg` ❌
- **接頭辞なし**: `menu.svg` ❌（必ず指定の接頭辞を使用）
- **未定義の接頭辞**: `pic-gallery.jpg` ❌（規定またはプロジェクトで定義した接頭辞以外は使用禁止）
