检索要发送到编辑器的图像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/