JavaScriptを読み込む方法

JavaScriptはscriptタグでHTMLに読み込みます。書き方は2通りあり、置く場所によって動き方が変わります。

まずこれだけ

JavaScriptは別ファイルにしてscriptタグのsrc属性で読み込むのが基本です。HTMLの要素を操作するなら、body終了タグの直前に置くか、deferを付けます。

scriptタグでJavaScriptを読み込む

JavaScriptをページで動かすには、HTMLの中に <script> タグを書きます。ブラウザはHTMLを上から読み、このタグに出会った時点でJavaScriptを読み込んで実行します。

書き方は、別ファイルを読み込む方法と、HTMLの中に直接書く方法の2通りです。どちらも <script> と </script> の組で書き、終了タグは省略できません。

簡単にいうと

JavaScriptはscriptタグで読み込み、置く場所で実行されるタイミングが決まります。

別ファイルを読み込む書き方

JavaScriptを .js という拡張子のファイルに書いておき、HTMLから読み込む方法です。ファイルの場所は src 属性で指定します。

たとえば <script src="main.js"> と書き、すぐ後に終了タグを続けます。この場合、タグの間には何も書きません。src属性を付けたscriptタグの中に書いたコードは実行されないためです。

別ファイルにすると、複数のページで同じコードを共有できます。修正も1か所で済むため、実際のサイトでは

srcに書くパスは、HTMLファイルから見た位置で指定します。jsフォルダに入れた場合は js/main.js のように書きます。パスが間違っていると読み込まれず、何も動きません。

こちらが基本です。

HTMLの中に直接書く書き方

src属性を付けずに、<script> と終了タグの間にコードを直接書くこともできます。そのページだけで使う短い処理や、動作を試すときに便利です。

ただし、同じ処理を複数のページに書くと、修正のたびにすべてのページを直す必要があります。ある程度の量になったら、別ファイルに分けるほうが管理しやすくなります。

HTMLの中に書いたコードも、書いた位置で実行される点は別ファイルの場合と同じです。置き場所の考え方も共通です。

置く場所で結果が変わる理由

ブラウザはHTMLを上から順に読みます。scriptタグを <head> の中に置くと、その時点ではまだ本文の要素が読み込まれていません。

この状態で「ボタンを探してクリックに反応させる」といった処理を実行すると、ボタンが見つからずにエラーになります。コード自体は正しくても、置き場所のせいで動かないことがあるので注意が必要です。

基本の置き場所

要素を操作するJavaScriptは、次のどちらかの形で読み込むのが一般的です。

bodyの最後
body終了タグの直前に置く。本文を読み込んだ後に実行される
headにdefer
headに置き、defer属性を付ける。HTMLを読み終えてから実行される

defer属性は、src属性の後ろに defer と書き加えるだけで指定できます。deferは外部ファイルの読み込みにだけ効きます。表示速度との関係は「表示速度・最適化」で扱います。

複数のファイルは読み込む順番に注意

複数のJavaScriptファイルを読み込む場合、基本的には書いた順に実行されます。あるファイルが別のファイルの機能を使っているなら、使われる側を先に読み込みます。

順番が逆になると、まだ存在しない機能を呼び出すことになり、エラーで止まります。ライブラリを使うときは、ライブラリを先に、自分のコードを後に読み込むのが原則です。

読み込み方の指定には async もあります。asyncを付けたファイルは読み込みが終わった順に実行されるため、実行順が決まっている処理には向きません。

WordPressでJavaScriptを追加する場合

WordPressでは、テーマのファイルに直接scriptタグを書くより、テーマやプラグインが用意している追加方法を使うのが一般的です。テーマを更新したときに消えてしまうことを防げます。

計測タグなど、指定された場所に貼るよう求められるコードもあります。その場合は、案内どおりにheadの中か、bodyの最後かを確認してから貼り付けます。

まとめ

JavaScriptはscriptタグで読み込み、別ファイルにしてsrc属性で指定するのが基本です。要素を操作する処理は、body終了タグの直前に置くか、headでdeferを付けて読み込むと、要素が見つからないエラーを防げます。