获取图像附件的img标记,如果请求将其缩小。

原型

get_image_tag( int $id, string $alt, string $title, string $align, string|array $size = 'medium' )

描述

‘get_image_tag_class’过滤器允许更改图像的类名,而无需在HTML内容上使用正则表达式。参数是:WordPress将用于什么类,附件ID,图像对齐值和图像应该是大小。

参数

$id (int) (Required) 附件ID。

$alt (string) (Required) alt属性的图像描述。

$title (string) (Required) 图标描述title属性。

$align (string) (Required) 用于对齐图像的类名的一部分。

$size (string|array) (Optional)  已注册的图像大小,用于检索标记。接受任何有效的图像大小,或以像素为单位的宽度和高度值数组(按此顺序)。

返回值

(string)  给定图像附件的HTML IMG元素

源文件

路径:wp-includes/media.php

<?php
...
function get_image_tag( $id, $alt, $title, $align, $size = 'medium' ) {
	list( $img_src, $width, $height ) = image_downsize($id, $size);
	$hwstring = image_hwstring($width, $height);
	$title = $title ? 'title="' . esc_attr( $title ) . '" ' : '';
	$class = 'align' . esc_attr($align) .' size-' . esc_attr($size) . ' wp-image-' . $id;
	/**
	 * Filters the value of the attachment's image tag class attribute.
	 *
	 * @since 2.6.0
	 *
	 * @param string       $class CSS class name or space-separated list of classes.
	 * @param int          $id    Attachment ID.
	 * @param string       $align Part of the class name for aligning the image.
	 * @param string|array $size  Size of image. Image size or array of width and height values (in that order).
	 *                            Default 'medium'.
	 */
	$class = apply_filters( 'get_image_tag_class', $class, $id, $align, $size );
	$html = '<img src="' . esc_attr($img_src) . '" alt="' . esc_attr($alt) . '" ' . $title . $hwstring . 'class="' . $class . '" />';
	/**
	 * Filters the HTML content for the image tag.
	 *
	 * @since 2.6.0
	 *
	 * @param string       $html  HTML content for the image.
	 * @param int          $id    Attachment ID.
	 * @param string       $alt   Alternate text.
	 * @param string       $title Attachment title.
	 * @param string       $align Part of the class name for aligning the image.
	 * @param string|array $size  Size of image. Image size or array of width and height values (in that order).
	 *                            Default 'medium'.
	 */
	return apply_filters( 'get_image_tag', $html, $id, $alt, $title, $align, $size );
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/get_image_tag/