Функция get_header_image_tag() в WordPress с примерами

Главная - WordPress Codex - Функция get_header_image_tag() в WordPress с примерами
Доступна с версии: 4.4
Раздел: Тема
Написал: Александр Сокирка

Функция get_header_image_tag() возвращает HTML-разметку изображения заголовка с набором атрибутов по умолчанию, включая src, width, height, alt и srcset. При необходимости, можно переопределить эти атрибуты через параметр $attr. Если для заголовка не установлено изображение, функция вернет пустую строку.

get_header_image_tag( array $attr = array() ): string

Параметры

  • $attr (массив, необязательный): Дополнительные атрибуты для изображения. Этот параметр позволяет переписать атрибуты по умолчанию, такие как alt, srcset, и другие.

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

  • string: Возвращает HTML-тег <img> с атрибутами изображения заголовка. Если изображение не задано, вернется пустая строка.

По умолчанию устанавливаются следующие атрибуты:

array(
	'src'    => $header->url,
	'width'  => $width,
	'height' => $height,
	'alt'    => get_bloginfo( 'name' ),
	'srcset' => '', // генерируется автоматически, если пусто
)

Пример 1: Получение и вывод изображения заголовка

Простой пример вывода изображения заголовка без дополнительных параметров:

$img = get_header_image_tag();
echo $img;

Выведет:

<img src="http://mywebsite.com/wp-content/uploads/2024/09/header-image.jpg" width="1024" height="600" alt="Заголовок моего сайта"
     srcset="http://mywebsite.com/wp-content/uploads/2024/09/header-image.jpg 1024w, http://mywebsite.com/wp-content/uploads/2024/09/header-image-small.jpg 480w, http://mywebsite.com/wp-content/uploads/2024/09/header-image-medium.jpg 768w"
     sizes="(max-width: 1024px) 100vw, 1024px" 
/>
Пример 2: Переопределение атрибутов

В этом примере добавляется собственный alt и удаляется атрибут srcset:

$img = get_header_image_tag( array(
    'srcset' => 'none',
    'alt' => 'Заголовок страницы',
    'width' => '800',
    'height' => '500',
) );
echo $img;

Выведет:

<img src="http://mywebsite.com/wp-content/uploads/2024/09/header-image.jpg" width="800" height="500" alt="Заголовок страницы" srcset="none" />

Заключение

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

Стартовая премиум тема для WordPress
Демо импорт тестового контента в 1 клик.
SEO оптимизированный и валидный код.
Множество готовых стартовых сайтов.
Лучшая документация и поддержка.
Опции персонализации контента.
Креативный и современный дизайн.
Тема для WordPress

Дополнительно по: Тема