eurobyte.ru - мощные сервера с Дата-центрами в Нидерландах и Москве. От 159 ₽/мес.
Kama2.6 лет назад2 EN

the_title_attribute() │ WP 2.3.0

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

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

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

Также эта функция может принимать параметры в виде строки: 'before=<h3>&after=</h3>'

1 раз — 0.005307 сек (очень медленно) | 50000 раз — 2.55 сек (быстро) | PHP 7.1.2, WP 4.7.3

Хуков нет.

Возвращает

null|Строку. null когда результат выводится на экран (echo=true). Заголовок когда результат возвращается (echo=true).

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

<?php the_title_attribute( $args ); ?>
$args(массив/строка)

Параметры в виде массива или строки. Можно передать следующие параметры:

  • before(строка)
    Текст/HTML код который нужно разместить перед заголовком.
    По умолчанию: ''

  • after(строка)
    Текст/HTML код который нужно разместить после заголовка.
    По умолчанию: ''

  • echo(логический)
    Вывести на экран (true) или возвратить для дальнейшей обработки (false).
    По умолчанию: true

  • post(число/объект)
    ID или объект записи.
    По умолчанию: текущая запись

По умолчанию: ''

Примеры

0

#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() WP 6.7.1

wp-includes/post-template.php 
function the_title_attribute( $args = '' ) {
	$defaults    = array(
		'before' => '',
		'after'  => '',
		'echo'   => true,
		'post'   => get_post(),
	);
	$parsed_args = wp_parse_args( $args, $defaults );

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

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

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

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

title (заголовок)

Записи: посты, страницы, ...

Записи: посты, страницы, ...

2 комментария
    Войти