header_image()


WordPress関数header_image()は、テーマで定義されているヘッダー画像のURLを取得します。

構文

<?php echo header_image(); ?>

例1. ヘッダー画像を表示する

テーマのヘッダー画像を直接表示します。

<?php echo '<img src="' . header_image() . '" alt="Header Image">'; ?>

例2. ヘッダー画像の背景を設定する

CSSを使用して、ヘッダー画像を背景として使用します。

<style>
  .custom-header {
    background-image: url('<?php echo header_image(); ?>');
  }
</style>
<div class="custom-header"></div>

例3. ヘッダー画像の幅と高さを取得する

ヘッダー画像の幅と高さを使用して、画像のスタイルを調整します。

<style>
  .header-image {
    width: <?php echo get_custom_header()->width; ?>px;
    height: <?php echo get_custom_header()->height; ?>px;
  }
</style>
<img src="<?php echo header_image(); ?>" class="header-image" alt="Header Image">

例4. デフォルトのヘッダー画像があるか確認する

デフォルトのヘッダー画像が設定されている場合にのみ表示します。

<?php if ( header_image() ) { ?>
  <img src="<?php echo header_image(); ?>" alt="Default Header Image">
<?php } ?>

例5. 条件に基づいて異なるヘッダー画像を表示する

特定の条件に基づいて、カスタムヘッダー画像を変更します。

<?php
if ( is_front_page() ) {
    echo '<img src="' . header_image() . '" alt="Front Page Header">';
} else {
    echo '<img src="path-to-default-image.jpg" alt="Default Header">';
}
?>

注意事項

  • header_image()関数は、テーマでサポートされるカスタムヘッダー画像が有効になっている必要があります。
  • テーマ内でadd_theme_support( 'custom-header' )を定義していない場合、この関数は動作しません。

関連機能：