2024年06月14日
WP関数:the_post_thumbnail()
この関数の説明
WP関数の the_post_thumbnail() は、現在の投稿に設定されているアイキャッチ画像(サムネール)を表示する関数です。
※具体的にはエスケープ処理された<img>タグが出力されます。
関数
the_post_thumbnail( $size, $attr )
パラメータ
$size(文字列 | 配列) (オプション)
表示する画像サイズを指定します。
省略した場合は set_post_thumbnail_size() で指定したサイズで表示されます。
・キーワードで指定する場合
'thumbnail', 'medium', 'large', 'full'
・直接指定(幅、高さ)する場合
array( 150, 150 )
$attr(配列) (オプション)
アイキャッチ画像を<img>タグで表示する時の属性/値を配列で記述します。
属性値 | 解説 |
class | クラス名 |
alt | オルト属性は、画像をテキストで説明するものです。 |
loading | 遅延読み込みを指定
'lazy' :遅延読込み(デフォルト) 'eager':遅延読込みをしない |
戻り値
ありません
利用事例
①アイキャッチ画像(サムネール)が設定されていた場合は表示します。
<?php if(has_post_thumbnail()){ the_post_thumbnail(); // デフォルトで表示 the_post_thumbnail(array(300,300)); // サイズ指定で表示 } ?>
■3行目:デフォルト表示
■4行目:サイズ指定
■サムネールが設定されているか否かは has_post_thumbnail() を参照してください。
■表示される画像サイズの計算は下記になります。
実債の画像サイズが(1000,800)の場合にarray( 150, 150 )で表示させると実際に表示される画像サイズ下記になります。
横:150
縦:120(150×800÷1000)
②属性値を指定してアイキャッチ画像(サムネール)を表示します。
<?php if(has_post_thumbnail()) { $attr = array( 'class' => 'my_img', 'alt' => 'my_image_ait', 'loading' =>'eager', ); the_post_thumbnail(array(150,150) , $attr ); } ?>
関連情報
関連関数は アイキャッチ関連関数 を参照してください