1. 首页
  2. WordPress 函数手册

is_category()

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

确定查询是否针对现有类别存档页。
Determines whether the query is for an existing category archive page.

目录锚点:#说明#参数#返回#源码#笔记


说明(Description)

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

有关此主题函数和类似主题函数的更多信息,请参阅主题开发人员手册中的条件标记文章。


参数(Parameters)

参数 类型 必填 说明
$category (int | string | int[] | string[]) 可选 要检查的类别ID、名称、段塞或数组。

返回(Return)

(bool)


源码(Source)

/**
 * Is the query for an existing category archive page?
 *
 * If the $category parameter is specified, this function will additionally
 * check if the query is for one of the categories specified.
 *
 * @since 1.5.0
 *
 * @global WP_Query $wp_query
 *
 * @param mixed $category Optional. Category ID, name, slug, or array of Category IDs, names, and slugs.
 * @return bool
 */
function is_category( $category = '' ) {
	global $wp_query;

	if ( ! isset( $wp_query ) ) {
		_doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1' );
		return false;
	}

	return $wp_query->is_category( $category );
}
更新版本 源码位置 使用 被使用
1.5.0 wp-includes/query.php:263 11 3

笔记(Notes)

实例

is_category() 为WP2原创文章,链接:https://www.wp2.cn/functions/is_category/

发表评论

您的电子邮箱地址不会被公开。