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

スクリプトの読み込み

type="module"・defer・async 属性によるスクリプトの読み込み方法と、インラインスクリプトを使ってよい例外

スクリプトは <head> 内で type="module" または defer 属性を付けて読み込みます。これにより、HTML の解析を止めずにスクリプトを読み込めます。

type=“module”(推奨)

ES モジュールを利用する場合は、type="module" を指定して読み込みます。モジュールスクリプトは自動的に defer と同じタイミングで実行されるため、defer 属性は不要です。

<head>
  <script type="module" src="/assets/js/main.js"></script>
</head>

defer(モジュールを使わない場合)

モジュールを使わないスクリプトは、defer 属性を付与して読み込みます。

<head>
  <script defer src="/assets/js/common.js"></script>
  <script defer src="/assets/js/page-specific.js"></script>
</head>

async(実行順や DOM に依存しない外部スクリプト)

外部ファイルとして読み込むスクリプトのうち、ほかのスクリプトとの実行順や DOM の構築に依存しないもの(計測・広告・チャットウィジェットなど)は、defer ではなく async を付けて読み込みます。

<script async src="https://example.com/widget.js"></script>

インラインスクリプトの例外

次の場合に限り、インラインスクリプトを使います。インラインに書くのは必要最小限のコードだけにしてください。

構造化データ

JSON-LD はデータなので、HTML に直接記述して構いません。書き方は SEOを参照してください。

計測タグ

Google Tag Manager などの計測タグは、提供元が指定するコードをそのまま <head> に貼り付けます。書き換えると計測できなくなることがあります。

<head>
  <!-- Google Tag Manager(提供元のコードをそのまま貼り付ける) -->
  <script>
    (function (w, d, s, l, i) { /* ... */ })(window, document, "script", "dataLayer", "GTM-XXXXXXX");
  </script>
</head>

表示のちらつき防止

ダークモードなど、ページを描画する前に決める必要がある状態は、<head> 内のインラインスクリプトで設定します。 defer やモジュールで読み込むと、一度描画された後に切り替わるため、画面がちらつきます。

<head>
  <script>
    document.documentElement.dataset.theme =
      localStorage.getItem("theme") ??
      (matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light");
  </script>
  <link rel="stylesheet" href="/assets/css/style.css" />
</head>

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