the_title_attribute() WP 2.3

Выводит заголовок записи подготовленный для использования в атрибутах html тега.

Функция должна использоваться внутри Цикла WordPress.

Функция идентична функции the_title(), стой лишь разницей, что эта функция "чистит" заголовок от HTML тегов и меняет HTML сущности (< ,>,",') на их HTML эквиваленты. Например, знак < будет заменен на &lt;. К заголовку применяются функции-фильтры: 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>

Код the_title_attribute: wp-includes/post-template.php ^{VER 5.0.1}

<?php
function the_title_attribute( $args = '' ) {
	$defaults = array( 'before' => '', 'after' =>  '', 'echo' => true, 'post' => get_post() );
	$r = wp_parse_args( $args, $defaults );

	$title = get_the_title( $r['post'] );

	if ( strlen( $title ) == 0 ) {
		return;
	}

	$title = $r['before'] . $title . $r['after'];
	$title = esc_attr( strip_tags( $title ) );

	if ( $r['echo'] ) {
		echo $title;
	} else {
		return $title;
	}
}

Cвязанные функции

Из метки: title (заголовок)

Еще из раздела: Записи: посты, страницы, ...

Еще из тегов шаблона: Записи: посты, страницы, ...