画像ファイルの命名規則
接頭辞ルール、ディレクトリ構成、ファイル名の構成、レスポンシブ・連番対応の命名規則
画像ファイルの名前は、種類を表す接頭辞で始め、英小文字の単語をハイフンでつなぎます(例: 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-を使う
ディレクトリ構成の例
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/ を置く場所は、開発環境テンプレートのディレクトリ構成に従ってください(Vite テンプレートは src/assets/、WordPress テンプレートは theme/src/assets/ の下)。Astro テンプレートでは、ビルド時に最適化する画像を src/assets/ の下に置きます。
ファイル名の構成要素
基本構成
[接頭辞]-[詳細]-[連番].[拡張子]
banner-hero-main.webp: メインのヒーロー画像img-product-gallery-01.webp: 商品ギャラリーの 1 枚目icon-arrow-right.svg: 右矢印アイコン
レスポンシブ対応時
ブレークポイントごとに別の画像(構図やトリミングが異なる画像)を用意する場合は、ブレークポイント名を付けます。
[接頭辞]-[詳細]-[ブレークポイント].[拡張子]
banner-hero-desktop.webp: PC 用ヒーロー画像banner-hero-tablet.webp: タブレット用ヒーロー画像banner-hero-mobile.webp: スマートフォン用ヒーロー画像
srcset 用に同じ画像を幅違いで書き出す場合は、ピクセル幅を付けます。
[接頭辞]-[詳細]-[幅].[拡張子]
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.webpfigure-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❌(規定またはプロジェクトで定義した接頭辞以外は使用禁止)