is_home() の使い方|説明・引数・注意点

説明

is_home() は、ブログ(投稿一覧)ページを表示しているかを判定する関数です。

基本構文

is_home(): bool

引数

引数はありません。

戻り値

条件に当てはまれば true、そうでなければ false。

使い方(サンプル)

if ( is_home() ) {
	// 投稿一覧ページ
}

注意点

  • フロントページに固定ページを設定している場合、is_home() は「投稿ページ」にだけ true になります。
  • 「トップページ」を判定したいときは is_front_page() を使います。
  • 設定が「最新の投稿」のとき、is_home() と is_front_page() は両方 true になります。

実務での使いどころ

  • 投稿の一覧ページ(ブログトップ)だけで、表示を変えるとき。
  • 固定ページをフロントページにしている場合に、投稿の一覧ページを判定するとき。

よくあるミスと対処

  • フロントページと同じだと思っている。is_home() は「投稿の一覧ページ」で、サイトのトップは is_front_page()。
  • 「ホームページの表示」を固定ページにしている場合、is_home() はトップページでは false になる。

NG例

if ( is_home() ) {
	// トップページ専用の処理のつもり(固定ページをトップにしていると、入らない)
}

OK例

if ( is_front_page() ) {
	// サイトのトップページ
}
if ( is_home() ) {
	// 投稿の一覧ページ
}

使い分け早見表

関数 当てはまるページ
is_front_page() サイトのトップページ(最新の投稿、または設定した固定ページ)
is_home() 投稿の一覧ページ(ブログトップ)
両方が true 「ホームページの表示」が「最新の投稿」のとき

関連項目

is_front_page()、is_archive()

公式リファレンス:is_home() | Function | WordPress Developer Resources

コメント

タイトルとURLをコピーしました