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

## 分割の方針

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

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

:::note
import / export を利用するには、`<script type="module">` で読み込む必要があります。詳しくは[スクリプトの読み込み](/frontend/js/loading)を参照してください。
:::

## 実行タイミングの制御

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

**main.js**

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

// 対象の要素がないページでは何もしない
document.querySelector('[data-js="alert-button"]')?.addEventListener("click", showAlert);
```

**show-alert.js**

```js show-alert.js
// ❌ 悪い例: import 時にすぐ実行される
alert("実行されました");

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

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

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

**main.js**

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

initAccordion();
initTabs();
```

**accordion.js**

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

  // 処理...
}
```
