MENU

get_stylesheet_directory_uri() とは?

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 / 画像読み込みで頻出

という、実務で非常に重要なテンプレートタグです。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

コメント

コメントする

CAPTCHA


目次