WordPressテーマの「現在有効なテーマ(通常は子テーマ)」のURLを取得するテンプレートタグです。
子テーマ運用を前提にする場合、こちらを使うケースが非常に多くなります。
目次
get_stylesheet_directory_uri() の役割
get_stylesheet_directory_uri() は現在有効になっているテーマのディレクトリURL を返します。
・子テーマが有効 → 子テーマ
・子テーマがない → 親テーマ
という挙動になります。
基本的な使い方
子テーマ内の画像を読み込む例です。
<img src="<?php echo get_stylesheet_directory_uri(); ?>/images/logo.png" alt="">functions.php での使用例
wp_enqueue_style(
'child-style',
get_stylesheet_directory_uri() . '/css/style.css'
);この場合、子テーマ内の css/style.css が読み込まれます。
なぜ子テーマではこちらを使うのか
子テーマを使う目的は、
・アップデートで上書きされない
・カスタマイズを安全に行う
ためです。
そのため、子テーマに置いたファイルはget_stylesheet_directory_uri() で参照するのが基本になります。
get_template_directory_uri() との比較
どちらを使うべき?
| 状況 | 使う関数 |
|---|---|
| 親テーマのファイル | get_template_directory_uri() |
| 子テーマのファイル | get_stylesheet_directory_uri() |
| 子テーマ前提の設計 | get_stylesheet_directory_uri() |
初心者向け覚え方
・template = 親
・stylesheet = 今使ってるテーマ
と覚えると混乱しにくいです。
まとめ
get_stylesheet_directory_uri() は、
・現在有効なテーマのURLを取得
・子テーマ運用で必須
・CSS / JS / 画像読み込みで頻出
という、実務で非常に重要なテンプレートタグです。

コメント