WordPress根据附件ID获取图像HTML元素函数:wp_get_attachment_image

文 / @UTHEME

WordPress函数wp_get_attachment_image可以根据附件ID获取该图像元素。

wp_get_attachment_image( int $attachment_id, string|int[] $size = 'thumbnail', bool $icon = false, string|array $attr = '' )

函数参数

$attachment_id

整数

附件的ID

$size

字符串或数字数组,默认值:thumbnail

要获取的图像大小,可以是已注册的图像大小名称,也可以是包含宽和高的数组,当该值为指定宽高的数组时,将返回等于或接近指定宽高的图像版本。因此,获取到的图像大小可能不预期,推荐使用已注册的图像大小名称。

$icon

布尔值,默认值:false

值为true时,如果附件为非图像文件,将显示对应的图标。

$attr

字符串或数组

图像HTML标记的属性

  • src:图像的URL路径;
  • class:类名,默认值是attachment-(size的名称);
  • srcset:srcset属性的值;
  • size:sizes属性的值;
  • loading:loading属性的值。

函数返回值

失败时返回空,成功时返回图像标签,例如:

<img width="768" height="430" src="https://tiezhushuo-1251540446.file.myqcloud.com/wp-content/uploads/2020/05/baidusrf-for-linux.webp" class="attachment-full size-full" alt="百度输入法Linux版本" loading="lazy">

函数使用示例

<?php
	echo wp_get_attachment_image(268, array('400', '300'), '', array('class' => 'img-responsive'));
?>

扩展阅读

wp_get_attachment_image()函数位于:wp-include/media.php

相关函数:

  • wp_get_loading_attr_default()
  • wp_lazy_loading_enabled()
  • wp_calculate_image_srcset()
  • wp_calculate_image_sizes()
  • wp_get_attachment_image_src()
  • wp_get_attachment_image_attributes()
  • image_hwstring()
  • wp_get_attachment_metadata()
添加UTHEME为好友
扫码添加UTHEME微信为好友
· 分享WordPress相关技术文章,主题上新与优惠动态早知道。
· 微信端最大WordPress社群,限时免费入群。