# get_image_tag()

URL: https://chugunov.pro/api-wordpress/functions/get_image_tag/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 2.5.0.

## Сигнатура

```php
get_image_tag( int $id, string $alt, string $title, string $align, string|int[] $size = 'medium' ): string
```

## Описание

Фильтр 'get_image_tag_class' позволяет изменить имя класса изображения без использования регулярных выражений над HTML-содержимым. Его параметры: имя класса, которое использует WordPress, идентификатор вложения, значение выравнивания изображения и требуемый размер изображения.
Второй фильтр, 'get_image_tag', получает HTML-содержимое, которое затем плагин может дополнительно изменить, поменяв все значения атрибутов и даже само HTML-содержимое.

## Параметры

- `$id` `int` — обязательный. Идентификатор вложения.
- `$alt` `string` — обязательный. Описание изображения для атрибута alt.
- `$title` `string` — обязательный. Описание изображения для атрибута title.
- `$align` `string` — обязательный. Часть имени класса для выравнивания изображения.
- `$size` `string|int[]` — необязательный, по умолчанию `'medium'`. Размер изображения. Принимает имя любого зарегистрированного размера изображения или массив значений ширины и высоты в пикселях (именно в таком порядке). Значение по умолчанию 'medium'.

## Возвращаемое значение

`string`

## Исходный код

Файл: `wp-includes/media.php:388`

```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 ) . '" ' : '';

	$size_class = is_array( $size ) ? implode( 'x', $size ) : $size;
	$class      = 'align' . esc_attr( $align ) . ' size-' . esc_attr( $size_class ) . ' 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|int[] $size  Requested image size. Can be any registered image size name, or
	 *                            an array of width and height values in pixels (in that order).
	 */
	$class = apply_filters( 'get_image_tag_class', $class, $id, $align, $size );

	$html = '<img src="' . esc_url( $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   Image description for the alt attribute.
	 * @param string       $title Image description for the title attribute.
	 * @param string       $align Part of the class name for aligning the image.
	 * @param string|int[] $size  Requested image size. Can be any registered image size name, or
	 *                            an array of width and height values in pixels (in that order).
	 */
	return apply_filters( 'get_image_tag', $html, $id, $alt, $title, $align, $size );
}
```

## История изменений

- 2.5.0 — Introduced.

## Связанные

Использует: [`image_downsize`](https://chugunov.pro/api-wordpress/functions/image_downsize/), [`image_hwstring`](https://chugunov.pro/api-wordpress/functions/image_hwstring/), [`esc_attr`](https://chugunov.pro/api-wordpress/functions/esc_attr/), [`esc_url`](https://chugunov.pro/api-wordpress/functions/esc_url/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: [`get_image_send_to_editor`](https://chugunov.pro/api-wordpress/functions/get_image_send_to_editor/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/get_image_tag/