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 );
}
?>
関連情報
関連関数は アイキャッチ関連関数 を参照してください