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

モジュール分割

ES モジュールの分割方針、エントリーポイントでの初期化、実行タイミングの制御

分割の方針

目的や機能ごとにファイルを分割します。実行タイミングを呼び出し側で制御できるように、処理は 1 つの関数にまとめて export してください。

// 関数として export する
export function initAccordion() {
  // 処理...
}

実行タイミングの制御

分割したモジュールの中で、import した時点で即座にブラウザや DOM に影響する処理が走る実装は避けてください。

import { showAlert } from "./show-alert.js";

// 対象の要素がないページでは何もしない
document.querySelector('[data-js="alert-button"]')?.addEventListener("click", showAlert);
// ❌ 悪い例: import 時にすぐ実行される
alert("実行されました");

// ✅ 良い例: 関数として export し、必要なときだけ実行
export function showAlert() {
  alert("実行されました");
}

エントリーポイントでの初期化

各モジュールの初期化関数は、エントリーポイント(HTML から読み込む main.js などのファイル)でまとめて呼び出します。 全ページで同じエントリーポイントを読み込む場合、対象の要素がないページでも関数が実行されます。初期化関数の冒頭で要素の有無を確認し、なければ何もせずに終了してください。

import { initAccordion } from "./accordion.js";
import { initTabs } from "./tabs.js";

initAccordion();
initTabs();
export function initAccordion() {
  const accordions = document.querySelectorAll('[data-js="accordion"]');
  // 対象の要素がないページでは何もしない
  if (accordions.length === 0) return;

  // 処理...
}

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