当前浏览:首页 / WordPress函数 / the_title_attribute()

the_title_attribute( string|array $args = '' )

在检索或显示时净化当前标题

attribute

themore...

titlemore...


描述

the_title()类似,只是参数可以是字符串或数组。有关$args参数中可以重写的内容,请参见函数。

标题会先去除标签并对其使用esc_attr(),然后才传递给用户或显示出来。默认情况与the_title()一样显示标题。


参数

$args

(string|array) (可选) 标题属性参数,可选择的

  • 'before'
    (string) 在标题前添加标记
  • 'after'
    (string) 在标题后添加标记
  • 'echo'
    (bool) 输出或返回标题,默认 true 输出标题
  • 'post'
    (WP_Post) 检索标题的当前文章对象

默认值: ''


返回

(void|string) 如果'echo'参数为true,则无返回;如果'echo'参数为false,则返回标题属性。



源码

查看源码 官方文档


更新日志

版本描述
2.3.0开始引入

使用示例

  • 示例1

    带有文本参数的PHP

    printf(	'<a href="%s" title="%s">%s</a>',
    	get_permalink(),
    	the_title_attribute( 'echo=0' ),
    	get_the_title()
    );
    
  • 示例2

    与数组参数内联

    <a href="<?php the_permalink(); ?>" 
    	title="<?php the_title_attribute( array(
    		'before' => 'Permalink to: ',
    		'after'  => ''
    	) ); ?>">
    	<?php the_title(); ?>
    </a>
    
  • 示例3

    与文本参数内联

    /**
     * Output the post title.
     */
    function wpdocs_do_post_title() {
    	?>
    	<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute( 'before=Permalink to: "&after="' ); ?>"><?php the_title(); ?></a>
    	<?php
    }