category_css_class
云策文档标注
概述
category_css_class 是一个 WordPress 过滤器钩子，用于修改 wp_list_categories() 函数中每个分类列表项的 CSS 类数组。它允许开发者自定义分类列表的样式类，增强前端展示的灵活性。
关键要点
- 过滤器钩子：category_css_class 用于过滤 wp_list_categories() 输出的分类列表项的 CSS 类。
- 参数：接受 $css_classes（CSS 类数组）、$category（WP_Term 对象）、$depth（深度）和 $args（wp_list_categories() 参数数组）。
- 用途：常用于主题或插件开发中，通过添加或移除 CSS 类来定制分类列表的样式。
- 相关函数：与 Walker_Category::start_el() 方法关联，用于在输出分类元素时应用过滤后的 CSS 类。
- 版本历史：自 WordPress 4.2.0 版本引入。
代码示例
$css_classes = implode( ' ', apply_filters( 'category_css_class', $css_classes, $category, $depth, $args ) );
原文内容
Filters the list of CSS classes to include with each category in the list.
Description
See also
Parameters
$css_classesstring[]-
An array of CSS classes to be applied to each list item.
$categoryWP_Term-
Category data object.
$depthint-
Depth of page, used for padding.
$argsarray-
An array of wp_list_categories() arguments.
More Arguments from wp_list_categories( … $args )
Array or string of arguments. See WP_Term_Query::__construct() for information on accepted arguments.
Source
$css_classes = implode( ' ', apply_filters( 'category_css_class', $css_classes, $category, $depth, $args ) );
Changelog
| Version | Description |
|---|---|
| 4.2.0 | Introduced. |