# the_title_attribute()

URL: https://chugunov.pro/api-wordpress/functions/the_title_attribute/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 2.3.0.

## Сигнатура

```php
the_title_attribute( string|array $args = '' ): void|string
```

## Описание

Работает как the_title() , за исключением того, что параметры могут передаваться строкой или массивом. Смотрите эту функцию, чтобы узнать, что можно переопределить в параметре $args .
Перед выводом из заголовка удаляются теги и он проходит через esc_attr() , прежде чем будет передан пользователю или выведен. По умолчанию, как и в the_title() , заголовок выводится.

## Параметры

- `$args` `string|array` — необязательный, по умолчанию `''`. Аргументы атрибутов заголовка. Необязательный.
  
  before stringРазметка, добавляемая перед заголовком.
  
  after stringРазметка, добавляемая после заголовка.
  
  echo boolВыводить заголовок или возвращать его. Значение по умолчанию true — для вывода.
  
  post WP_PostCurrent объект записи, для которой нужно получить заголовок.

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

`void|string` — 'echo' 'echo'

## Исходный код

Файл: `wp-includes/post-template.php:81`

```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;
	}
}
```

## История изменений

- 2.3.0 — Introduced.

## Связанные

Использует: [`get_the_title`](https://chugunov.pro/api-wordpress/functions/get_the_title/), [`esc_attr`](https://chugunov.pro/api-wordpress/functions/esc_attr/), [`wp_parse_args`](https://chugunov.pro/api-wordpress/functions/wp_parse_args/), [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/).
Используется в: [`feed_links_extra`](https://chugunov.pro/api-wordpress/functions/feed_links_extra/), [`get_adjacent_post_rel_link`](https://chugunov.pro/api-wordpress/functions/get_adjacent_post_rel_link/), [`get_the_content`](https://chugunov.pro/api-wordpress/functions/get_the_content/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/the_title_attribute/