has_header_image()


WordPress関数has_header_image()は、現在のテーマにヘッダー画像が設定されているかを確認するために使用されます。

構文

has_header_image();

例1: ヘッダー画像の有無を確認する

現在のテーマにヘッダー画像が設定されている場合にHTMLを出力します。

<?php
if ( has_header_image() ) {
    echo '<div>ヘッダー画像が設定されています。</div>';
}
?>

例2: ヘッダー画像を背景に設定する

ヘッダー画像が設定されている場合、スタイル属性で背景画像として使用します。

<?php
if ( has_header_image() ) {
    echo '<div style="background-image: url(' . get_header_image() . ');">ヘッダーセクション</div>';
}
?>

例3: ヘッダー画像がある場合とない場合での処理

条件分岐でヘッダー画像の有無に応じた異なるメッセージを出力します。

<?php
if ( has_header_image() ) {
    echo '<div>カスタムヘッダー画像が使用されています。</div>';
} else {
    echo '<div>ヘッダー画像は設定されていません。</div>';
}
?>

例4: カスタムCSSでヘッダー画像を適用

動的にCSSを生成してページに埋め込みます。

<?php
if ( has_header_image() ) {
    echo '<style>
        .site-header {
            background-image: url(' . get_header_image() . ');
            background-size: cover;
            background-position: center;
        }
    </style>';
}
?>

例5: ヘッダー画像のURLを取得して出力する

現在のヘッダー画像のURLを取得して表示します。

<?php
if ( has_header_image() ) {
    echo '<img src="' . get_header_image() . '" alt="ヘッダー画像">';
}
?>

注意事項

  • has_header_image() はヘッダー画像が有効化されているかどうかを確認するためだけの関数です。画像そのものを出力しません。
  • ヘッダー画像の取得には別途 get_header_image() を使用してください。
  • テーマでヘッダー画像をサポートしていない場合、この関数は常に false を返します。

関連機能：