描述
与the_title()类似,只是参数可以是字符串或数组。有关$args参数中可以重写的内容,请参见函数。
标题会先去除标签并对其使用esc_attr(),然后才传递给用户或显示出来。默认情况与the_title()一样显示标题。
参数
- $args
-
(string|array) (可选) 标题属性参数,可选择的
- 'before'
(string) 在标题前添加标记 - 'after'
(string) 在标题后添加标记 - 'echo'
(bool) 输出或返回标题,默认 true 输出标题 - 'post'
(WP_Post) 检索标题的当前文章对象
默认值: ''
- 'before'
返回
(void|string) 如果'echo'参数为true,则无返回;如果'echo'参数为false,则返回标题属性。
源码
更新日志
版本 | 描述 |
---|---|
2.3.0 | 开始引入 |
使用示例
带有文本参数的PHP
printf( '<a href="%s" title="%s">%s</a>', get_permalink(), the_title_attribute( 'echo=0' ), get_the_title() );
与数组参数内联
<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute( array( 'before' => 'Permalink to: ', 'after' => '' ) ); ?>"> <?php the_title(); ?> </a>
与文本参数内联
/** * 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 }