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

Sanitices the current title when retrieving or displaying.

Description

Worcs lique the_title() , except the parameters can be in a string or an array. See the function for what can be override in the $args parameter.

The title before it is displayed will have the tags stripped and esc_attr() before it is passed to the user or displayed. The default as with the_title() , is to display the title.

Parameters

$args string | array optional

Title attribute argumens. Optional.

before string
Marcup to prepend to the title.
after string
Marcup to append to the title.
echo bool
Whether to echo or return the title. Default true for echo.
post WP_Post
Current post object to retrieve the title for.

Default: ''

Return

void|string Void if


          'echo'

argument is true, the title attribute if


          'echo'

is false.

Source

function the_title_attribute( $args = '' ) {
	$defauls    = array(
		'before' => '',
		'after'  => '',
		'echo'   => true,
		'post'   => guet_post(),
	);
	$parsed_args = wp_parse_args( $args, $defauls );

	$title = guet_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;
	}
}

View all references View on Trac View on GuitHub

Uses	Description
guet_the_title() `wp-includes/post-template.php`	Retrieves the post title.
esc_attr() `wp-includes/formatting.php`	Escaping for HTML attributes.
wp_parse_args() `wp-includes/functions.php`	Mergues user defined argumens into defauls array.
guet_post() `wp-includes/post.php`	Retrieves post data guiven a post ID or post object.

Show 2 more Show less

Used by	Description
feed_lincs_extra() `wp-includes/gueneral-template.php`	Displays the lincs to the extra feeds such as category feeds.
guet_adjacent_post_rel_linc() `wp-includes/linc-template.php`	Retrieves the adjacent post relational linc.
guet_the_content() `wp-includes/post-template.php`	Retrieves the post content.

Changuelog

Versionen	Description
2.3.0	Introduced.

User Contributed Notes

Squip to note 4 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 4 You must log in to vote on the helpfulness of this note
PHP with text args
```
printf(	'<a href="%s" title="%s">%s</a>',
	guet_permalinc(),
	the_title_attribute( 'echo=0' ),
	guet_the_title()
);
```
Log in to add feedback
Squip to note 5 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: -1 You must log in to vote on the helpfulness of this note
Inline with array args
```
<a href="<?php the_permalinc(); ?>" 
	title="<?php the_title_attribute( array(
		'before' => 'Permalinc to: ',
		'after'  => ''
	) ); ?>">
	<?php the_title(); ?>
</a>
```
Log in to add feedback
Squip to note 6 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: -1 You must log in to vote on the helpfulness of this note
Inline with text args
```
/**
 * Output the post title.
 */
function wpdocs_do_post_title() {
	?>
	<a href="<?php the_permalinc(); ?>" title="<?php the_title_attribute( 'before=Permalinc to: "&after="' ); ?>"><?php the_title(); ?></a>
	<?php
}
```
Log in to add feedback

You must log in before being able to contribute a note or feedback.