get_image_send_to_editor()

检索要发送到编辑器的图像HTML。

原型

get_image_send_to_editor( int $id, string $caption, string $title, string $align, string $url = '', bool|string $rel = false, string|array $size = 'medium', string $alt = '' )

参数

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

$caption (string) (Required) 图片标题。

$title (string) (Required) 图像标题属性。

$align (string) (Required) 图像CSS对齐属性。

$url (string) (Optional)  图像src URL。

$rel (bool|string) (Optional)  rel属性的值或是否添加默认值。

$size (string|array) (Optional)  图片尺寸。接受任何有效的图像大小，或以像素为单位的宽度和高度值数组（按此顺序）。

$alt (string) (Optional)  图像alt属性。

返回值

(string)  要插入编辑器的HTML输出。

源文件

路径：wp-admin/includes/media.php

<?php
...
function get_image_send_to_editor( $id, $caption, $title, $align, $url = '', $rel = false, $size = 'medium', $alt = '' ) {
	$html = get_image_tag( $id, $alt, '', $align, $size );
	if ( $rel ) {
		if ( is_string( $rel ) ) {
			$rel = ' rel="' . esc_attr( $rel ) . '"';
		} else {
			$rel = ' rel="attachment wp-att-' . intval( $id ) . '"';
		}
	} else {
		$rel = '';
	}
	if ( $url )
		$html = '<a href="' . esc_attr( $url ) . '"' . $rel . '>' . $html . '</a>';
	/**
	 * Filters the image HTML markup to send to the editor when inserting an image.
	 *
	 * @since 2.5.0
	 *
	 * @param string       $html    The image HTML markup to send.
	 * @param int          $id      The attachment id.
	 * @param string       $caption The image caption.
	 * @param string       $title   The image title.
	 * @param string       $align   The image alignment.
	 * @param string       $url     The image source URL.
	 * @param string|array $size    Size of image. Image size or array of width and height values
	 *                              (in that order). Default 'medium'.
	 * @param string       $alt     The image alternative, or alt, text.
	 */
	$html = apply_filters( 'image_send_to_editor', $html, $id, $caption, $title, $align, $url, $size, $alt );
	return $html;
}
...
?>

其他

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