get_attachment_icon() - WordPress 函数参考中文文档

返回介绍

get_attachment_icon()

发布于 2017-09-10 字数3142 浏览 946 评论 0

Warning: This function has been deprecated. Use wp_get_attachment_image() instead.

get_attachment_icon( int $id,  bool $fullsize = false,  array $max_dims = false )

Retrieve HTML content of icon attachment image element.


描述


参数

$id

(int)
(Optional)
Post ID.

$fullsize

(bool)
(Optional)
default to false. Whether to have full size image.

Default value: false

$max_dims

(array)
(Optional)
Dimensions of image.

Default value: false


返回值

(false|string) HTML content.


源代码

File: wp-includes/deprecated.php

function get_attachment_icon( $id = 0, $fullsize = false, $max_dims = false ) {
	_deprecated_function( __FUNCTION__, '2.5.0', 'wp_get_attachment_image()' );
	$id = (int) $id;
	if ( !$post = get_post($id) )
		return false;

	if ( !$src = get_attachment_icon_src( $post->ID, $fullsize ) )
		return false;

	list($src, $src_file) = $src;

	// Do we need to constrain the image?
	if ( ($max_dims = apply_filters('attachment_max_dims', $max_dims)) && file_exists($src_file) ) {

		$imagesize = getimagesize($src_file);

		if (($imagesize[0] > $max_dims[0]) || $imagesize[1] > $max_dims[1] ) {
			$actual_aspect = $imagesize[0] / $imagesize[1];
			$desired_aspect = $max_dims[0] / $max_dims[1];

			if ( $actual_aspect >= $desired_aspect ) {
				$height = $actual_aspect * $max_dims[0];
				$constraint = "width='{$max_dims[0]}' ";
				$post->iconsize = array($max_dims[0], $height);
			} else {
				$width = $max_dims[1] / $actual_aspect;
				$constraint = "height='{$max_dims[1]}' ";
				$post->iconsize = array($width, $max_dims[1]);
			}
		} else {
			$post->iconsize = array($imagesize[0], $imagesize[1]);
			$constraint = '';
		}
	} else {
		$constraint = '';
	}

	$post_title = esc_attr($post->post_title);

	$icon = "<img src='$src' title='$post_title' alt='$post_title' $constraint/>";

	return apply_filters( 'attachment_icon', $icon, $post->ID );
}

更新日志

Version 描述
2.5.0 Use wp_get_attachment_image()
2.0.0 Introduced.

相关函数

Uses

  • wp-includes/formatting.php:
    esc_attr()
  • wp-includes/deprecated.php:
    get_attachment_icon_src()
  • wp-includes/functions.php:
    _deprecated_function()
  • wp-includes/plugin.php:
    apply_filters()
  • wp-includes/post.php:
    get_post()

Used By

  • wp-includes/deprecated.php:
    get_attachment_innerHTML()

User Contributed Notes

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!