wp_get_attachment_image 类 - PHP

wp_get_attachment_image 是一个 WordPress 函数，它可以获取任何附件的图像。它是用 PHP 编写的，主要是在主题或插件中使用。

参数

wp_get_attachment_image 函数需要按以下格式传递参数：

wp_get_attachment_image(
    $attachment_id,  // 附件 ID
    $size = 'thumbnail',  // 图片尺寸
    $icon = false,  // 是否是图标
    $attr = '',  // 图片属性
)

• $attachment_id (必填) ：附件的 ID，可以是图像、音频或视频文件。
• $size (可选): 图像的尺寸。默认为缩略图（thumbnail），其他可用选项包括 medium、large 和 full。
• $icon (可选): 是否限定图像大小，而不是使用预定义的图像大小。默认为 false，表示使用预定义的图像大小。
• $attr (可选): 图像属性。可以添加以下属性：alt、class、height、width、src、title 等。

返回值

wp_get_attachment_image 函数返回一个图片 HTML 标签。默认情况下，它是一个带有缩略图 URL 的 <img> 标签，但您还可以在 $size 参数中指定其他图像尺寸。

返回代码片段：

```html
<img src="url" alt="description" class="alignleft size-full" width="500" height="300" />

用法示例

以下是 wp_get_attachment_image 函数的使用示例：

// 获取图像 ID 和其他属性
$image_id = get_post_thumbnail_id( $post_id );
$image_attributes = wp_get_attachment_image_src( $image_id, 'large' );
$alt_text = get_post_meta( $image_id, '_wp_attachment_image_alt', true );

// 输出图像
echo wp_get_attachment_image( $image_id, 'large', false, array(
    'alt' => $alt_text,
    'class' => 'my-image',
    'width' => $image_attributes[1],
    'height' => $image_attributes[2],
) );

结论

wp_get_attachment_image 函数是 WordPress 开发中常见的一个函数，它可以通过附件 ID 检索并呈现图像到 WordPress 站点中。它有一些可调整的参数，使开发人员可以轻松地玩转它。