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

is_category( int|string|int[]|string[] $category = '' )

是否为现有的类别存档页

cat

category 分类more...

is 条件判断more...


描述

如果指定了$category参数,此函数将另外检查查询是否针对指定的类别之一。

更多类似的主题函数信息,请查看主题开发手册中的条件标签文章。


参数

$category

(int|string|int[]|string[]) (可选) 要检查的类别ID、name、slug或其数组。

默认值: ''


返回

(bool) 查询是否针对现有类别存档页。


说明

  • 此函数只针对内置的"category"分类法,针对自定义分类请使用 is_tax()


源码

查看源码 官方文档


更新日志

版本描述
1.5.0开始引入

用户贡献的笔记

  • 贡献者:Codex

    示例

    is_category();
    // When any Category archive page is being displayed.
    
    is_category( '9' );
    // When the archive page for Category 9 is being displayed.
    
    is_category( 'Stinky Cheeses' );
    // When the archive page for the Category with Name "Stinky Cheeses" is being displayed.
    
    is_category( 'blue-cheese' );
    // When the archive page for the Category with Category Slug "blue-cheese" is being displayed.
    
    is_category( array( 9, 'blue-cheese', 'Stinky Cheeses' ) );
    // Returns true when the category of posts being displayed is either term_ID 9,
    // or slug "blue-cheese", or name "Stinky Cheeses".
    // Note: the array ability was added in version 2.5.