Question

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 = '' )

Retrieves the image HTML to send to the editor.

---

description

---

参数

$id

(int) (Required) Image attachment id.

$caption

(string) (Required) Image caption.

$title

(string) (Required) Image title attribute.

$align

(string) (Required) Image CSS alignment property.

$url

(string) (Optional) Image src URL.

Default value: ''

$rel

(bool|string) (Optional) Value for rel attribute or whether to add a default value.

Default value: false

$size

(string|array) (Optional) Image size. Accepts any valid image size, or an array of width and height values in pixels (in that order).

Default value: 'medium'

$alt

(string) (Optional) Image alt attribute.

Default value: ''

---

返回值

(string) The HTML output to insert into the editor.

---

源代码

File: wp-admin/includes/media.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 源代码 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;
}

---

更新日志

Version	description
2.5.0	Introduced.

---

相关函数

Uses

• wp-admin/includes/media.php: image_send_to_editor
• wp-includes/formatting.php: esc_attr()
• wp-includes/plugin.php: apply_filters()
• wp-includes/media.php: get_image_tag()

---

Used By

• wp-admin/includes/media.php: image_media_send_to_editor()
• wp-admin/includes/ajax-actions.php: wp_ajax_send_attachment_to_editor()

---

User Contributed Notes