page_css_class
云策文档标注
概述
page_css_class 是一个 WordPress 过滤器钩子，用于修改页面列表项中的 CSS 类数组。它允许开发者在 wp_list_pages() 函数输出时自定义每个页面项的样式类。
关键要点
- 过滤器名称：page_css_class
- 主要用途：过滤页面列表项的 CSS 类数组，便于样式定制
- 相关函数：与 wp_list_pages() 和 Walker_Page::start_el() 关联使用
- 引入版本：WordPress 2.8.0
代码示例
$css_classes = implode( ' ', apply_filters( 'page_css_class', $css_class, $page, $depth, $args, $current_page_id ) );注意事项
- 参数包括：$css_class（CSS 类数组）、$page（WP_Post 对象）、$depth（页面深度）、$args（参数数组）、$current_page_id（当前页面 ID）
- 需确保返回值为字符串数组，以正确应用于 HTML 类属性
原文内容
Filters the list of CSS classes to include with each page item in the list.
Description
See also
Parameters
$css_classstring[]-
An array of CSS classes to be applied to each list item.
$pageWP_Post-
Page data object.
$depthint-
Depth of page, used for padding.
$argsarray-
An array of arguments.
$current_page_idint-
ID of the current page.
Source
$css_classes = implode( ' ', apply_filters( 'page_css_class', $css_class, $page, $depth, $args, $current_page_id ) );
Changelog
| Version | Description |
|---|---|
| 2.8.0 | Introduced. |