the_category() - WordPress 函数参考中文文档

返回介绍

the_category()

发布于 2017-09-11 字数3356 浏览 922 评论 0

the_category( string $separator = '',  string $parents = '',  int $post_id = false )

Display category list for a post in either HTML list or custom format.


描述


参数

$separator

(string)
(Optional)
Separator between the categories. By default, the links are placed in an unordered list. An empty string will result in the default behavior.

Default value: ”

$parents

(string)
(Optional)
How to display the parents.

Default value: ”

$post_id

(int)
(Optional)
Post ID to retrieve categories.

Default value: false


源代码

File: wp-includes/category-template.php

function the_category( $separator = '', $parents = '', $post_id = false ) {
	echo get_the_category_list( $separator, $parents, $post_id );
}

更新日志

Version 描述
0.71 Introduced.

相关函数

Uses

  • wp-includes/category-template.php:
    get_the_category_list()

User Contributed Notes

  1. Skip to note content

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Contributed by Codex

    Separated by Space
    List categories with a space as the separator.

    
    <?php the_category( ' ' ); ?>
    
  2. Separated by Comma
    Displays links to categories, each category separated by a comma (if more than one).

    
    <?php the_category( ', ' ); ?>
    

    Separated by Arrow
    Displays links to categories with an arrow (>) separating the categories. Note: Take care when using this, since some viewers may interpret a category following a > as a subcategory of the one preceding it.

    
    <?php the_category( '&gt; ' ); ?>
    

    Separated by a Bullet
    Displays links to categories with a bullet (•) separating the categories.

    
    <?php the_category( '&bull;' ); ?>
    

    $parents
     ▪ ‘multiple’ – Display separate links to parent and child categories, exhibiting “parent/child” relationship. (Exhibiting the parents and child with links pointing for both)
     ▪ ‘single’ – Display link to child category only, with link text exhibiting “parent/child” relationship. (Exhibiting the parents and child but the link points only to the child category)

上一篇:the_author_yim()

下一篇:the_category_head()

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!