鸡西网—微信标志
  • 鸡西网站制作
  • 鸡西网客服热线已更改为”400-0467-004“,请广大客户周知。
  • 鸡西网站设计为您提供免费技术问答.如有您有计算机的相关问题欢迎前来咨询!
  • 敢不敢在鸡西网High一下
  • 网站地图

WordPress菜单函数详解

WordPress Danny.✔ 5025浏览 0评论 百度收否

导航菜单是每一个WordPress主题必须的元素,如果你要制作一个WordPress主题,那就必须熟悉WordPress导航菜单注册函数 register_nav_menus() 和 导航菜单调用函数wp_nav_menu() ,这两个参数一般都是配合使用的。今天我们就一起来解释一下这两个函数,并举例说明。

导航菜单注册函数 register_nav_menus() 介绍

register_nav_menus() 是3.0以后用来注册自定义菜单的函数,通过它可以很方便地给你的主题注册一个或多个菜单,在主题的 functions.php 中添加:

 

register_nav_menus( array(
	'header_menu' => 'My Custom Header Menu',
	'footer_menu' => 'My Custom Footer Menu'
) );

 

上面的代码注册了两个代码,其中 ‘header_menu’  和 ‘footer_menu’ 分别是这两个菜单的“键key”,而后面的 ‘My Custom Header Menu’ 和 ‘My Custom Footer Menu’ 是对这个菜单的描述,会在 外观 – 菜单 中显示出来。下文将会图例说明。

按照上面的结构,就可以注册多个菜单。

wp_nav_menu() 是WordPress 3.0 以后添加的一个自定义导航菜单调用函数,可用来调用 register_nav_menus() 注册的菜单。wp_nav_menu()的使用方法位于wp-includes/nav-menu-templates.php文件中。

可以通过 <?php wp_nav_menu( $args ); ?> 来调用菜单,其中参数 $args 的默认值如下:

 

<?php

$defaults = array(
	'theme_location'  => '',
	'menu'            => '',
	'container'       => 'div',
	'container_class' => '',
	'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" class="%2$s">%3$s</ul>',
	'depth'           => 0,
	'walker'          => ''
);

wp_nav_menu( $defaults );

?>

 

每个参数的详细介绍如下:

  • $theme_locaton:(字符串)(可选)

默认值: None

用于在调用导航菜单时指定注册过的某一个导航菜单名,如果没有指定,则显示第一个。

 

wp_nav_menu(array( 'theme_location'   =>'primary')); //调用第一个菜单

 

  • $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

导航菜单注册和调用示例

要想定义出灵活强大的菜单,需要我们熟悉上面介绍的 导航菜单注册函数 register_nav_menus() 和 导航菜单调用函数wp_nav_menu() 。

1.首先我们先要激活 WordPress 3.0 以后的自定义菜单功能,也就是要注册菜单。在主题的 functions.php文件中添加下面的代码:

//添加导航
    register_nav_menus(array(
      'left-menu' => '左边栏菜单',
      'top-menu' => '顶部菜单',
    ));

这样我们就注册了 左边栏菜单 和顶部菜单,你可以在 外观-菜单 中查看到:

我们可以使用下面的函数调用 左边栏菜单:

<?php 
  if(function_exists('wp_nav_menu')) {
      wp_nav_menu(array( 'theme_location' => 'left-menu','container_id'=>'menu_left') ); 
  }
?>

其中,’theme_location’ 后面的值 是 ‘left-menu’,就是调用前面注册的那个 左边栏菜单,而 ‘container_id’ 自定义为 ‘menu_left’,最终输出的html结构如下:

<div id="menu_left" class="menu-xxx-container">
  <ul class="menu">
    <li><a href="http://www.7vnet.com">首页</a></li>
  </ul>
</div>

也就是说,菜单使用 <div id=”menu_left”>……</div> 来包含了,接下来,你就可以根据这个 id 来写css美化菜单的显示效果了。

小结:只要灵活运用 导航菜单注册函数 register_nav_menus() 和 导航菜单调用函数wp_nav_menu() ,加上一流的前端技术,就能设计出强大和漂亮的菜单啦!

转载请注明:七网科技 » WordPress菜单函数详解

发表我的评论
取消评论

表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址

网友最新评论 (7)

  1. 宝宝说给我奖励,给我买好吃的。。。哈哈哈。。。
    Danny.✔2013-12-10 18:34 回复
  2. 一叶叶,一声声,泪眼婆娑!知我意、感君心,心似长江水,此情无歇时。你是我今生唯一的传奇,宝宝我爱你……
    2013-12-10 18:49 回复
    • 我要一辈子都和你在一起,永远永远永永远都不要和你分开。。。。
      Danny.✔2013-12-10 18:52 回复
  3. Danny.✔2013-12-11 23:56 回复
  4. 亲爱的宝宝,我知道你一定心里不舒服了。我总是白天睡觉,晚上干活。和你的作息时间总是岔开,导致我们都没有时间好好的说会儿话,我没有做到好好的陪着你。宝宝,老公给你道歉,对不起宝宝,请宝宝原谅。老公尽量改,好不好。不要不痛快了,乖啊宝宝。。。开开心心的。。。。我爱你。。。
    Danny.✔2013-12-27 01:29 回复
  5. 话我说了几箩筐,道理我讲了几火车,甚至日复一日的喋喋不休,滔滔不绝……可换来的只是瞬间的动容,短暂的改变!至今日我已经尽力了,也许是习惯了,亦或许是更不愿意自己带给你的是聒噪不休的感受吧!(事实上你已经这么认为)。就像你说的,你有你的道理和习惯,这也许就是你们这个职业的通病。我没有生气,更真的不需要你的道歉,所以你根本不用说对不起。看着听着我爱你这三个字,我真的想告诉你,一个人只有好好爱自己,(好好的爱自己的身体)才能更好的爱你所爱的人,这也是我得病后最大的心得,以前的我就像你一样根本不能理解这些,但是现在我真的想让你明白……
    2013-12-27 07:43 回复
  6. 时至今日的时没打上去
    2013-12-27 08:55 回复