wp_get_attachment_image()

Q: wp_get_attachment_image() で表示できるサイズは何ですか？

デフォルトでは 'thumbnail', 'medium', 'large', 'full' の4種類が使用できますが、add_image_size() でカスタムサイズを追加することも可能です。

Q: wp_get_attachment_image() でリンク付きの画像を表示するには？

get_attachment_link() と組み合わせてリンク付きの画像を表示できます。 $attachment_id = 123;echo '<a href="' . get_attachment_link($attachment_id) . '">';echo wp_get_attachment_image($attachment_id, 'thumbnail');echo '</a>';

Q: wp_get_attachment_image() のalt属性は自動で入りますか？

いいえ、デフォルトでは自動でalt属性が追加されません。必要に応じて第4引数の$attrで指定してください。

Function

2025/4/3 Thursday

wp_get_attachment_image() は、指定した添付ファイルのIDに基づいて、HTMLの<img>タグを生成して画像を出力するためのテンプレートタグです。

機能の説明

wp_get_attachment_image() は、画像添付ファイルを取得し、<img>タグとして出力する関数です。

サイズを指定することで、サムネイルやフルサイズの画像を表示することができます。また、class属性やaltテキストなどを含めた柔軟なHTML出力が可能です。

シンプルなコード例

echo wp_get_attachment_image(123, 'thumbnail');

添付ファイルIDが123の画像をサムネイルサイズで表示します。

使い方の解説

引数

wp_get_attachment_image($attachment_id, $size, $icon, $attr)

$attachment_id: 表示したい画像の添付ファイルID
$size: 画像サイズ（例: 'thumbnail', 'medium', 'full'など）
$icon: アイコン表示（trueまたはfalse）
$attr: HTML属性（連想配列でclassやaltを指定可能）

戻り値

HTMLの<img>タグを返します。

使用例

$attachment_id = 123;
echo wp_get_attachment_image($attachment_id, 'medium', false, array('class' => 'my-custom-class', 'alt' => 'カスタム画像'));

IDが123の画像をmediumサイズで表示し、カスタムクラスmy-custom-classと、alt属性に「カスタム画像」を追加します。

一緒に使うことが多い関連タグ

`wp_attachment_is_image()`

wp_attachment_is_image() は、指定したIDの添付ファイルが画像であるかどうかを判定するためのテンプレートタグです。

$attachment_id = 123;
if (wp_attachment_is_image($attachment_id)) {
    echo wp_get_attachment_image($attachment_id, 'large');
} else {
    echo '<p>このファイルは画像ではありません。</p>';
}

画像であればその画像をlargeサイズで表示し、画像でない場合はメッセージを表示します。

`get_post_mime_type()`

get_post_mime_type() は、指定した投稿や添付ファイルのMIMEタイプを取得する関数です。

$attachment_id = 123;
echo 'このファイルのMIMEタイプは: ' . get_post_mime_type($attachment_id);

添付ファイルIDが123のファイルのMIMEタイプ（例: 'image/jpeg'）を表示します。

複数の関連タグを組み合わせたコード

$attachment_id = 123;

if (wp_attachment_is_image($attachment_id)) {
    echo wp_get_attachment_image($attachment_id, 'full');
    echo '<p>この画像のMIMEタイプは: ' . get_post_mime_type($attachment_id) . '</p>';
}

画像ファイルであればfullサイズで表示し、そのMIMEタイプも一緒に表示します。

追加情報を取得したい場合

`wp_get_attachment_metadata()` で画像の詳細情報を取得

$metadata = wp_get_attachment_metadata(123);
print_r($metadata);

IDが123の画像メタデータ（幅や高さ、生成されたサムネイル情報など）を配列で取得し、表示します。

出力できる情報

width：画像の幅
height：画像の高さ
file：画像ファイルのパス
sizes：各サイズのサムネイル情報

想定されるトラブル

添付ファイルIDが間違っている

添付ファイルIDが正しく取得できていない可能性があります。

解決方法

管理画面でファイルIDを確認してください。
get_the_ID() で現在のIDを正しく取得しているか確認します。

希望のサイズが表示されない

指定した画像サイズが登録されていない可能性があります。

解決方法

add_image_size() で必要なサイズを追加します。
Regenerate Thumbnailsプラグインでサムネイルを再生成します。

Q&A

`wp_get_attachment_image()` で表示できるサイズは何ですか？

デフォルトでは 'thumbnail', 'medium', 'large', 'full' の4種類が使用できますが、add_image_size() でカスタムサイズを追加することも可能です。

`wp_get_attachment_image()` でリンク付きの画像を表示するには？

get_attachment_link() と組み合わせてリンク付きの画像を表示できます。

$attachment_id = 123;
echo '<a href="' . get_attachment_link($attachment_id) . '">';
echo wp_get_attachment_image($attachment_id, 'thumbnail');
echo '</a>';