has_image_size()


WordPress関数has_image_size()は、指定した画像サイズが登録されているかどうかを確認するために使用されます。この関数を使用することで、テーマやプラグインで特定の画像サイズの有無をチェックできます。

構文

has_image_size( string $name );
  • $name (string) — チェックする画像サイズの名前。例: ‘thumbnail’, ‘medium’, ‘large’など。

例1: サムネイルサイズの確認

以下のコードは、’thumbnail’サイズが登録されているかを確認します。

<?php if ( has_image_size('thumbnail') ) { echo 'サムネイルサイズが登録されています。'; } ?>

例2: カスタム画像サイズの確認

‘custom-size’という名前のカスタム画像サイズが登録されているかを確認します。

<?php if ( has_image_size('custom-size') ) { echo 'カスタムサイズが利用可能です。'; } ?>

例3: 条件に応じた出力の切り替え

特定の画像サイズが登録されている場合のみ、画像を表示します。

<?php
if ( has_image_size('medium') ) {
    echo '<img src="' . get_the_post_thumbnail_url() . '" alt="">';
}
?>

例4: 画像サイズが存在しない場合のデフォルトメッセージ

登録されていない場合にメッセージを表示します。

<?php
if ( ! has_image_size('large') ) {
    echo 'このサイズの画像は登録されていません。';
}
?>

例5: すべての登録画像サイズをループでチェック

現在登録されているすべての画像サイズを確認し、利用可能なものを出力します。

<?php
$sizes = ['thumbnail', 'medium', 'large', 'custom-size'];
foreach ( $sizes as $size ) {
    if ( has_image_size($size) ) {
        echo $size . 'サイズが登録されています。<br>';
    }
}
?>

注意点

  • has_image_size()は、登録された画像サイズのみを確認します。
  • 関数がfalseを返す場合、画像サイズが登録されていない可能性があります。
  • 画像サイズをカスタマイズする場合、add_image_size()を使用してサイズを登録する必要があります。

関連機能：