WordPress 函数 wp_get_attachment_image()

WordPress

描述

若附件是图像，函数尝试返回其缩略图或适当大小的图像，若附件不是图像则返回mime图标。

用法

<?php wp_get_attachment_image( $attachment_id, $size, $icon, $attr ); ?>

返回:(字符串)HTML img元素;如果执行失败将返回空字符串。

参数

$attachment_id

（整数）希望用到的附件的编号。必需。

$size

（字符 | 数组）附件形式的图片尺寸：字符串关键字（thumbnail, medium, large or full），或者仅含有表示高度和宽度像素的数组，如array(32,32)。在WordPress 2.5中，该参数并不影响媒体图标的大小，图标以原始尺寸显示图片。可选，默认thumbnail。

虽然$size将接受数组大小,最好注册一个大小与add_image_size()生成裁剪版本。

$icon

(布尔)(可选)使用一个媒体图标来表示附件。

默认值:“false”

$attr

(字符串、数组)(可选)查询字符串或数组的属性。

默认值: ''（无）

$default_attr = array(
	'src'	=> $src,
	'class'	=> "attachment-$size",
	'alt'   => trim(strip_tags( get_post_meta($attachment_id, '_wp_attachment_image_alt', true) )),
);

$attr的默认属性。

例子

所有图片显示为一个列表

显示所有的图片和标题附加到某个页面,显示他们可以使用以下列表:

<ul>
<?php if ( have_posts() ) : while ( have_posts() ) : the_post();    

 $args = array(
   'post_type' => 'attachment',
   'numberposts' => -1,
   'post_status' => null,
   'post_parent' => $post->ID
  );

  $attachments = get_posts( $args );
     if ( $attachments ) {
        foreach ( $attachments as $attachment ) {
           echo '<li>';
           echo wp_get_attachment_image( $attachment->ID, 'full' );
           echo '<p>';
           echo apply_filters( 'the_title', $attachment->post_title );
           echo '</p></li>';
          }
     }

 endwhile; endif; ?>
</ul>

源文件

wp_get_attachment_image()位于 wp-includes/media.php.

参考文章

https://developer.wordpress.org/reference/functions/wp_get_attachment_image/

http://www.uedsc.com/wordpress-wp_get_attachment_image.html