the_title_attribute()

Функция the_title_attribute() выводит заголовок записи в html атрибутах. Работает как the_title(), но может принимать параметры в виде строки или массива.

Параметры

  • $args string|array
    • before string
      Текст перед заголовком
    • after string
      Текст перед заголовком
    • echo bool
      Выводить или вернуть заголовок в переменную
    • post WP_Post
      Текущий объект записи, для которого требуется получить заголовок
  • По умолчанию: ''
the_title_attribute( $args );

Возвращает

void|string void, если echo аргумент имеет значение true, string – при echo = false

Дополнительная информация

  1. Перед выводом, заголовок будет обработан функцией esc_attr(), которая очистит его от html тегов.
  2. Функцию часто используют внутри цикла (loop) WordPress, но можно использовать и вне, с обязательным указанием параметра post.
  3. Параметры можно передать в виде строки через разделитель &. Например, 'before=<h2>&after=</h2>'.

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

Пример 1. Вывод заголовка записи в атрибут title

<a href="<?php echo get_the_permalink() ?>" title="<?php the_title_attribute() ?>">
    <?php echo get_the_title() ?>
</a>

Хуки

Нет

Информация о функции

Добавлена в версии 2.3.0

wp-includes/post-template.php

Исходный код в Github

Другие функции

is_404()

Определяет, является ли текущая страница страницей ошибки 404.

wp_get_document_title()

Возвращает заголовок текущей страницы.

wp_title()

Выводит или возвращает заголовок страницы для использования в теге title.

single_post_title()

Выводит или возвращает заголовок текущего поста (записи, страницы, кастомного типа).

get_the_title()

Возвращает заголовок записи/страницы.

the_title()

Используется для вывода на экран или получения заголовка текущей записи/страницы.