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

画像ファイルの命名規則

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

画像ファイルの名前は、種類を表す接頭辞で始め、英小文字の単語をハイフンでつなぎます(例: 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.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 ❌(規定またはプロジェクトで定義した接頭辞以外は使用禁止)

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