the_title_attribute() WP 2.3
Выводит заголовок записи подготовленный для использования в атрибутах html тега.
Функция должна использоваться внутри Цикла WordPress.
Функция идентична функции the_title(), стой лишь разницей, что эта функция "чистит" заголовок от HTML тегов и меняет HTML сущности (< ,>,",') на их HTML эквиваленты. Например, знак <
будет заменен на <
. К заголовку применяются функции-фильтры: esc_attr() и strip_tags()
Также эта функция может принимать параметры в виде строки: 'before=<h3>&after=</h3>'
Хуков нет.
Возвращает
null/строку. null когда результат выводится на экран (echo=true). Заголовок когда результат возвращается (echo=true).
Использование
<?php the_title_attribute( $args ); ?>
- $args(массив/строка)
Параметры в виде массива или строки. Можно передать следующие параметры:
-
before(строка)
Текст/HTML код который нужно разместить перед заголовком.
По умолчанию: '' -
after(строка)
Текст/HTML код который нужно разместить после заголовка.
По умолчанию: '' -
echo(логический)
Вывести на экран (true) или возвратить для дальнейшей обработки (false).
По умолчанию: true - post(число/объект)
ID или объект записи.
По умолчанию: текущая запись
По умолчанию: ''
-
Примеры
#1. Пример использования функции в атрибуте title
тега <a>
.
Так как в этом атрибуте не допускается использования html тегов кавычек и прочего, то мы не можем там использовать функцию the_title(). Взамен используем the_title_attribute():
<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute( array('before' => 'Permalink to: ', 'after' => '')); ?>"> <?php the_title(); ?> </a>
Список изменений
С версии 2.3.0 | Введена. |
Код the_title_attribute() the title attribute WP 5.6
Cвязанные функции
Из метки: title (заголовок)
Еще из раздела: Записи: посты, страницы, ...
- edit_post_link()
- get_delete_post_link()
- get_edit_post_link()
- get_permalink()
- get_post_field()
- get_post_status()
- get_post_time()
- get_sample_permalink()
- get_the_content()
- get_the_date()
Еще из тегов шаблона: Записи: посты, страницы, ...
- body_class()
- get_post_format()
- have_posts()
- in_the_loop()
- next_image_link()
- next_post_link()
- next_posts_link()
- post_class()