スクリプトの読み込み
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>