Функция wp_get_attachment_image() - WordPres Коды и Элементы

Содержание

Описание функции
Примеры использования
Получение изображения с использованием функции wp_get_attachment_image()
Изменение размера изображения с помощью функции wp_get_attachment_image()
Добавление классов к изображению с помощью функции wp_get_attachment_image()
Изменение атрибута alt у изображения с помощью функции wp_get_attachment_image()
Использование атрибута srcset с функцией wp_get_attachment_image()
Вопросы и ответы
Как получить URL изображения, используя функцию wp_get_attachment_image()?
Как изменить размер изображения, полученного с помощью функции wp_get_attachment_image()?
Как добавить CSS класс к изображению, полученному с помощью функции wp_get_attachment_image()?
Как изменить атрибут alt у изображения, полученного с помощью функции wp_get_attachment_image()?
Как добавить атрибут srcset к изображению, полученному с помощью функции wp_get_attachment_image()?
Как изменить атрибут sizes у изображения, полученного с помощью функции wp_get_attachment_image()?
Как изменить атрибут loading у изображения, полученного с помощью функции wp_get_attachment_image()?
Как изменить атрибут decoding у изображения, полученного с помощью функции wp_get_attachment_image()?
Связанные элементы

Описание функции

Функция wp_get_attachment_image() возвращает HTML-элемент img, представляющий изображение вложения. Она используется для получения разметки изображения вложения, которую можно вставить в шаблон или контент WordPress.

Использование

wp_get_attachment_image( int $attachment_id, string|int[] $size = 'thumbnail', bool $icon = false, string|array $attr = '' ): string

В этом примере кода функция wp_get_attachment_image() принимает следующие параметры:

$attachment_id (обязательный) — ID изображения вложения.
$size (необязательный) — Размер изображения. Принимает имя зарегистрированного размера изображения или массив значений ширины и высоты в пикселях (в указанном порядке). По умолчанию ‘thumbnail’.
$icon (необязательный) — Определяет, должно ли изображение быть обработано как иконка. По умолчанию false.
$attr (необязательный) — Атрибуты для разметки изображения. Возможные значения:

src — URL изображения вложения.
class — CSS-класс или список классов, разделенных пробелами. По умолчанию используется ‘attachment-$size_class size-$size_class’, где $size_class — это запрашиваемый размер изображения.
alt — Описание изображения для атрибута ‘alt’.
srcset — Значение атрибута ‘srcset’.
sizes — Значение атрибута ‘sizes’.
loading — Значение атрибута ‘loading’. Значение false приведет к пропуску атрибута для изображения. По умолчанию ‘lazy’, в зависимости от настроек ленивой загрузки.
decoding — Значение атрибута ‘decoding’. Возможные значения: ‘async’ (по умолчанию), ‘sync’ или ‘auto’. Значение false или пустая строка приведет к пропуску атрибута.

Функция возвращает строку с HTML-элементом img или пустую строку в случае ошибки.

<?php
  $attachment_id = 123; // ID изображения вложения
  $size = 'medium'; // Размер изображения
  $icon = false; // Изображение не является иконкой
  $attr = array(
    'srcset' => 'image-2x.jpg 2x, image-3x.jpg 3x', // Значение атрибута 'srcset'
    'sizes' => '(max-width: 600px) 480px, 800px', // Значение атрибута 'sizes'
    'loading' => 'lazy', // Значение атрибута 'loading'
    'decoding' => 'async' // Значение атрибута 'decoding'
  );
  $image = wp_get_attachment_image( $attachment_id, $size, $icon, $attr );
  echo $image;
?>

В этом примере кода функция wp_get_attachment_image() используется для получения разметки изображения вложения с определенными атрибутами. Результат сохраняется в переменной $image и выводится на экран с помощью echo.

Примеры использования

Получение изображения с использованием функции wp_get_attachment_image()


$attachment_id = 123; // ID изображения
$image = wp_get_attachment_image( $attachment_id, 'full' );
echo $image;

В данном примере мы получаем полное изображение с помощью функции wp_get_attachment_image(). Первым параметром передается ID изображения, вторым параметром — размер изображения (в данном случае ‘full’). Результатом выполнения функции является HTML-код изображения, который мы выводим с помощью echo.

Изменение размера изображения с помощью функции wp_get_attachment_image()


$attachment_id = 123; // ID изображения
$image = wp_get_attachment_image( $attachment_id, array( 300, 200 ) );
echo $image;

В данном примере мы изменяем размер изображения с помощью функции wp_get_attachment_image(). Вторым параметром передается массив с шириной и высотой изображения в пикселях. Результатом выполнения функции является HTML-код изображения с измененным размером.

Добавление классов к изображению с помощью функции wp_get_attachment_image()


$attachment_id = 123; // ID изображения
$classes = array( 'image', 'featured' ); // Массив классов
$image = wp_get_attachment_image( $attachment_id, 'thumbnail', false, array( 'class' => $classes ) );
echo $image;

В данном примере мы добавляем классы к изображению с помощью функции wp_get_attachment_image(). Четвертым параметром передается массив с ключом ‘class’ и значением, которое является массивом классов. Результатом выполнения функции является HTML-код изображения с добавленными классами.

Изменение атрибута alt у изображения с помощью функции wp_get_attachment_image()


$attachment_id = 123; // ID изображения
$alt = 'Alternative text'; // Альтернативный текст
$image = wp_get_attachment_image( $attachment_id, 'thumbnail', false, array( 'alt' => $alt ) );
echo $image;

В данном примере мы изменяем атрибут alt у изображения с помощью функции wp_get_attachment_image(). Четвертым параметром передается массив с ключом ‘alt’ и значением, которое является альтернативным текстом. Результатом выполнения функции является HTML-код изображения с измененным атрибутом alt.

Использование атрибута srcset с функцией wp_get_attachment_image()


$attachment_id = 123; // ID изображения
$srcset = 'image-300x200.jpg 300w, image-600x400.jpg 600w'; // Значение атрибута srcset
$image = wp_get_attachment_image( $attachment_id, 'thumbnail', false, array( 'srcset' => $srcset ) );
echo $image;

В данном примере мы используем атрибут srcset с функцией wp_get_attachment_image(). Четвертым параметром передается массив с ключом ‘srcset’ и значением, которое является строкой со значением атрибута srcset. Результатом выполнения функции является HTML-код изображения с заданным атрибутом srcset.

Вопросы и ответы

Как получить URL изображения, используя функцию wp_get_attachment_image()?

Для получения URL изображения с помощью функции wp_get_attachment_image() необходимо передать ID вложения в качестве первого аргумента. Функция вернет HTML-элемент img с URL изображения в атрибуте src.


$attachment_id = 123; // ID вложения
$image_url = wp_get_attachment_image( $attachment_id, 'full' ); // Получение URL изображения

Как изменить размер изображения, полученного с помощью функции wp_get_attachment_image()?

Для изменения размера изображения, полученного с помощью функции wp_get_attachment_image(), необходимо передать второй аргумент функции размер изображения. Размер может быть задан в виде зарегистрированного имени размера или массива значений ширины и высоты в пикселях.


$attachment_id = 123; // ID вложения
$image_size = array( 800, 600 ); // Размер изображения
$resized_image = wp_get_attachment_image( $attachment_id, $image_size ); // Изменение размера изображения

Как добавить CSS класс к изображению, полученному с помощью функции wp_get_attachment_image()?

Для добавления CSS класса к изображению, полученному с помощью функции wp_get_attachment_image(), необходимо передать третий аргумент функции в виде строки с именем класса или пробела-разделителя списка классов.


$attachment_id = 123; // ID вложения
$image_class = 'my-image-class'; // CSS класс
$image_with_class = wp_get_attachment_image( $attachment_id, 'thumbnail', false, array( 'class' => $image_class ) ); // Добавление CSS класса к изображению

Как изменить атрибут alt у изображения, полученного с помощью функции wp_get_attachment_image()?

Для изменения атрибута alt у изображения, полученного с помощью функции wp_get_attachment_image(), необходимо передать четвертый аргумент функции в виде строки с описанием изображения.


$attachment_id = 123; // ID вложения
$image_alt = 'My image'; // Описание изображения
$image_with_alt = wp_get_attachment_image( $attachment_id, 'thumbnail', false, array( 'alt' => $image_alt ) ); // Изменение атрибута alt у изображения

Как добавить атрибут srcset к изображению, полученному с помощью функции wp_get_attachment_image()?

Для добавления атрибута srcset к изображению, полученному с помощью функции wp_get_attachment_image(), необходимо передать значение атрибута в параметр $attr в виде строки.


$attachment_id = 123;
$size = 'medium';
$attr = 'srcset="image.jpg 1024w, image-2x.jpg 2048w"';
$image = wp_get_attachment_image( $attachment_id, $size, false, $attr );

Как изменить атрибут sizes у изображения, полученного с помощью функции wp_get_attachment_image()?

Для изменения атрибута sizes у изображения, полученного с помощью функции wp_get_attachment_image(), необходимо передать значение атрибута в параметр $attr в виде строки.


$attachment_id = 123;
$size = 'medium';
$attr = 'sizes="(max-width: 600px) 100vw, (max-width: 1200px) 50vw, 800px"';
$image = wp_get_attachment_image( $attachment_id, $size, false, $attr );

Как изменить атрибут loading у изображения, полученного с помощью функции wp_get_attachment_image()?

Для изменения атрибута loading у изображения, полученного с помощью функции wp_get_attachment_image(), необходимо передать значение атрибута в параметр $attr в виде строки.


$attachment_id = 123;
$size = 'medium';
$attr = 'loading="lazy"';
$image = wp_get_attachment_image( $attachment_id, $size, false, $attr );

Как изменить атрибут decoding у изображения, полученного с помощью функции wp_get_attachment_image()?

Для изменения атрибута decoding у изображения, полученного с помощью функции wp_get_attachment_image(), необходимо передать значение атрибута в параметр $attr в виде строки.


$attachment_id = 123;
$size = 'medium';
$attr = 'decoding="auto"';
$image = wp_get_attachment_image( $attachment_id, $size, false, $attr );

Функция wp_get_attachment_image() позволяет получить HTML-элемент img, представляющий изображение вложения. С помощью параметра $attr можно добавить атрибуты srcset, sizes, loading и decoding к изображению. Это полезно для оптимизации загрузки и отображения изображений на веб-странице.

Связанные элементы

Функция wp_get_attachment_image_src(): Возвращает URL, ширины и высоты изображения вложения.
Функция wp_get_attachment_image_url(): Возвращает URL изображения вложения.
Функция wp_get_attachment_caption(): Возвращает описание изображения вложения.
Функция wp_get_attachment_metadata(): Возвращает метаданные изображения вложения.
Функция wp_get_attachment_thumb_file(): Возвращает путь к файлу миниатюры изображения вложения.
Функция wp_get_attachment_thumb_url(): Возвращает URL миниатюры изображения вложения.
Функция wp_get_attachment_image_sizes(): Возвращает доступные размеры изображения вложения.
Функция wp_get_attachment_image_srcset(): Возвращает значение атрибута srcset для изображения вложения.