首页 / 技术 / 正文

WordPress导航菜单wp_nav_menu()参数说明

2014年02月18日 1 条评论 ... 技术 /

在wordpress中的wp_nav_menu()函数,功能是显示导航栏菜单,此函数是一般用在 header.php 文件中,但是要使此函数生效,必须在 function.php 文件中添加注册函数:

register_nav_menus( array(
'header_menu' => '首页菜单',
'footer_menu' => ‘底部菜单'
) );

上述代码注册了两个菜单,一个叫做 header_menu ,在后台设置中显示的名称是“头部菜单”,第二个叫做 footer_menu ,在后台显示的是“底部菜单”。以此类推,如果还有更多的菜单,只要在数组变量中继续添加即可。   wp_nav_menu()默认参数说明:

<?php $defaults = array( 'theme_location'  => '', 'menu'            => '', 'container'       => 'div', 'container_class' => 'menu-{menu slug}-container', 'container_id'    => '', 'menu_class'      => 'menu', 'menu_id'         => '', 'echo'            => true, 'fallback_cb'     => 'wp_page_menu', 'before'          => '', 'after'           => '', 'link_before'     => '', 'link_after'      => '', 'items_wrap'      => '<ul id="%1$s">%3$s</ul>', 'depth'           => 0, 'walker'          => '' ); ?> <?php wp_nav_menu( $defaults ); ?>

参数说明

$theme_locaton:(字符串)(可选) 默认值: None 用于在调用导航菜单时指定注册过的某一个导航菜单名,如果没有指定,则显示第一个。

$menu:(字符串)(可选) 默认值: None 使用导航菜单的名称调用菜单,可以是 id, slug, name (按顺序匹配的) 。

$container:(字符串)(可选) 默认值: div ul 父节点(这里指导航菜单的容器)的标签类型,只支持div 和 nav 标签, 如果是其它值, ul 父节点的标签将不会被显示。也可以用false(container => false)去掉ul父节点标签。

$container_class:(字符串)(可选) 默认值: menu-{menu slug}-container ul 父节点的 class 属性值。

$container_id:(字符串)(可选) 默认值: None ul 父节点的 id 属性值。

$menu_class:(字符串)(可选) 默认值: menu ul 节点的 class 属性值。

$menu_id:(字符串)(可选) 默认值: menu slug, 自增长的 ul 节点的 id 属性值。

$echo:(布尔型)(可选) 默认值: true (直接显示) 确定直接显示导航菜单还是返回 HTML 片段,如果想将导航的代码作为赋值使用,可设置为false。

$fallback_cb:(字符串)(可选) 默认值: wp_page_menu (显示页面列表作为菜单) 用于没有在后台设置导航时调的回调函数。

$before:(字符串)(可选) 默认值: None 显示在每个菜单链接前的文本。

$after:(字符串)(可选) 默认值: None 显示在每个菜单链接后的文本。

$link_before:(字符串)(可选) 默认值: None 显示在每个菜单链接文本前的文本。

$link_after:(字符串)(可选) 默认值: None 显示在每个菜单链接文本后的文本。

$items_wrap:(字符串)(可选) 默认值: None 使用字符串替换修改ul的class。

$depth:(整型)(可选) 默认值: 0 显示菜单的深度, 当数值为 0 时显示所有深度的菜单。

$walker:(对象型)(可选) 默认值:  new Walker_Nav_Menu 自定义的遍历对象,调用一个对象定义显示导航菜单。

 

注意说明: wp_nav_menu()中所有参数都是可选的,其中$theme_locaton,设置主要使用的菜单 填写方式

wp_nav_menu(array( 'theme_location' =>'primary'));

1 条评论

Loading...
  1. 小虾

    我这个学期要进军wordpress主题开发了,你多多更新哈,我常来学习

    2014-02-19 [回复]

发布评论