スタイルシートを登録し、読み込み対象としてキューに追加します。キューに追加されたスタイルシートは、wp_head() が出力されるタイミングで自動的に読み込まれ、サイトに適用されます。
wp_enqueue_style($handle,$src,$deps,$ver,$media);| 引数 | 必須/任意 | 引数に指定するもの |
|---|---|---|
| 第1引数 $handle | 必須 | スタイルシートのハンドル名(文字列)※ハンドル名はスタイルシートに割り当てる固有の名前です。 |
| 第2引数 $src | 任意 | スタイルシートのパス(文字列)初期値: '' (空の文字列) |
| 第3引数 $deps | 任意 | このスタイルシートが依存する他のスタイルシートのハンドル名(配列)初期値: [] (空の配列)※他のスタイルシートのハンドル名を指定するとそのスタイルシートよりも後に呼び出されます。 |
| 第4引数 $ver | 任意 | スタイルシートのバージョン(文字列)初期値: false |
| 第5引数 $media | 任意 | メディアタイプを文字列で指定します。例: 'all' / 'print' / 'screen' あるいはメディアクエリ初期値: 'all' |
スタイルシートを登録し、読み込み対象としてキューに追加します。
下記の例では、get_theme_file_uri()を使ってテーマ直下にあるcssディレクトリ内のstyle.min.cssをキューに追加しています。キューに追加されたCSSはwp_head()で呼び出されます。詳しくはページ下の「よくある使い方」を参照してください。
wp_enqueue_style('main', get_theme_file_uri('/css/style.min.css'), [], 'v2026.1.1');【引数とは】
テンプレートタグ(=関数)を実行する際に、引数を渡すことができるテンプレートタグがあります。引数は、関数の中で使われるので、渡す引数の値によって実行結果が変わってきます。何を処理したいのか、どのようなデータを取得したいのかによって渡す引数が変わります。
【引数について】
下記の例では、2つのCSSをwp_enqueue_style()で、2つのJavaScriptをwp_enqueue_script()でキューに追加しています。キューに追加されたcssはwp_head()で呼び出されます。JavaScriptは設定次第でwp_head()あるいはwp_footer()で呼び出されます。詳しくはwp_enqueue_script()を参照ください。
function my_theme_scripts() {
wp_enqueue_style('main', get_theme_file_uri('/css/style.min.css'), ['swiper'], '2.1');
wp_enqueue_style('swiper', get_theme_file_uri('/lib/swiper/swiper.min.css'), [], '1.1');
wp_enqueue_script('main', get_theme_file_uri('/js/script.js'), ['swiper'], '1.0', true);
wp_enqueue_script('swiper', get_theme_file_uri('/lib/swiper/swiper-bundle.min.js'), [], '1.0', true);
}
add_action('wp_enqueue_scripts', 'my_theme_scripts');このコードを実行すると下記のようにlink要素がwp_head()で呼び出されます。なお、style.min.cssはswiper.min.cssに依存する指定なので(依存関係を指定する第3引数でswiperを指定)、見た目の順番通りではなく、mainはswiperの後に呼び出されます。
結果例:<link rel='stylesheet' id='swiper-css' href='https://example.com/wp-content/themes/template-theme/lib/swiper/swiper.min.css?ver=1.1' type='text/css' media='all' /><link rel='stylesheet' id='main-css' href='https://example.com/wp-content/themes/template-theme/css/style.min.css?ver=2.1' type='text/css' media='all' />
※javaScriptは割愛しています。
※当サイトでは初期値とデフォルト値の言葉の定義を区別せず、原則統一して初期値を採用しています。