函数名称：wp_page_menu()
函数描述：生成一个基于页面的导航菜单
用法：wp_page_menu( $args )
参数：
$args (array) (可选)生成菜单的参数。默认值为空数组。
'sort_column' => 'menu_order, post_title', // 按照菜单顺序和页面标题排序
'menu_class' => '', // 菜单的class属性
'menu_id' => '', // 菜单的id属性
'echo' => true, // 是否直接输出菜单，默认为true，即直接输出
'link_before' => '', // 链接文本之前的内容
'link_after' => '', // 链接文本之后的内容
'depth' => 0, // 菜单的嵌套层级，默认为0，即只显示一级菜单
'walker' => '', // 自定义菜单行为类的名称
返回值：如果设置了echo参数为false，则返回生成的菜单HTML，否则返回null。
示例：
生成一个基于页面的导航菜单：
生成一个带有自定义class和id的导航菜单：
'custom-menu-class',
'menu_id' => 'custom-menu-id'
);
wp_page_menu( $args );
?>
解析：
wp_page_menu函数用于生成一个基于页面的导航菜单。默认情况下，函数会根据页面的菜单顺序和标题来生成菜单。
可以通过$args参数来自定义生成菜单的行为。常用参数如下：
- sort_column: 指定菜单的排序方式，默认为'menu_order, post_title'，即按照菜单顺序和页面标题排序。
- menu_class: 指定菜单的class属性。
- menu_id: 指定菜单的id属性。
- echo: 是否直接输出菜单，默认为true，即直接输出。如果设置为false，则返回生成的菜单HTML。
- link_before: 链接文本之前的内容。
- link_after: 链接文本之后的内容。
- depth: 指定菜单的嵌套层级，默认为0，即只显示一级菜单。
- walker: 自定义菜单行为类的名称。使用自定义的Walker类可以实现更高级的菜单功能。
示例中的第一个例子没有传入$args参数，所以生成的菜单使用了默认的参数值。第二个例子传入了一个包含自定义class和id的$args参数，生成的菜单会带有这些自定义属性。
需要注意的是，wp_page_menu函数在生成菜单时只考虑了页面，而不考虑其他内容类型（如文章）。如果需要生成包含其他内容类型的菜单，可以使用wp_nav_menu函数。
0 个评论