register_nav_menus()(注册菜单)
register_nav_menus() 函数用来注册一个菜单,菜单指的是 WordPress 3.0+ 的菜单管理器,注册之后用户就可以在菜单管理器里拖动生成导航菜单了。
用法
register_nav_menus( $locations );
参数
$locations
(数组)(必须)要注册的菜单,键值为菜单 ID,键名为菜单名称,可以一次创建多个。
默认值:None
返回值
该函数无返回值。
例子
/** *建立菜单 *http://www.endskin.com/register_nav_menus/ */ function Bing_register_nav_menus(){ register_nav_menus( array( 'header_menu' => __( '顶部菜单', 'Bing' ), 'footer_menu' => __( '页脚菜单', 'Bing' ) )); } add_action( 'init', 'Bing_register_nav_menus' );
其它
该函数位于:wp-includes/nav-menu.php
wp_nav_menu()(菜单调用)
下面就来说一下怎么调用用户添加好后的菜单。
调用菜单主要使用 wp_nav_menu() 函数,wp_nav_menu() 函数的参数比较多,所以功能非常强大,这里会一个一个的讲解。
用法
wp_nav_menu( $args );
参数
参数只有一个 $args,但这是一个数组,通过给数组添加参数,可以定制更多细节,下边是默认值:
$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
(字符串)(可选)要调用的菜单的名字,比如 header_menu,如果没指定,则默认显示第一个注册的菜单。
默认值:None
menu
(字符串)(可选)使用导航菜单的名称调用菜单,可以是 ID、别名和名字(按顺序匹配)。
默认值:None
container
(字符串)(可选)导航菜单的容器类型,只支持 div 和 nav 标签,如果是其它值,ul 父节点的标签将不会显示。也可以设置成 False 去掉 ul 父节点。
默认值:div
container_class
(字符串)(可选)ul 父节点的 class 属性。
默认值:menu-{menu slug}-container
container_id
(字符串)(可选)ul 父节点的 id 属性。
默认值:None
menu_class
(字符串)(可选)ul 节点的 class 属性。
默认值:None
menu_id
(字符串)(可选)ul 节点的 id 属性。
默认值:菜单别名
echo
(布尔)(可选)返回导航菜单的 Html 代码还是直接打印输出,如果你想把导航菜单代码存到变量里请设置成 False.
默认值:True(直接打印输出)
fallback_cb
(回调函数)(可选)后台没有设置此菜单时默认显示的内容。
默认值:wp_page_menu
before
(字符串)(可选)显示在每个菜单链接前的文本。
默认值:None
after
(字符串)(可选)显示在每个菜单链接后的文本。
默认值:None
link_before
(字符串)(可选)显示在每个菜单链接文本前的文本。
默认值:None
link_after
(字符串)(可选)显示在每个菜单链接文本后的文本。
默认值:None
items_wrap
(字符串)(可选)替换 ul 的 class 属性。
默认值:None
depth
(整形)(可选)
显示菜单的深度,当数值为 0 时显示所有深度的菜单。
默认值:0
walker
(对象)(可选)菜单的结构对象。
默认值:new Walker_Nav_Menu
例子
<"topmenu">%3$s</ul>', 'fallback_cb' => 'Bing_menu_null_fallback' ) ); ?>
其它
此函数位于:wp-includes/nav-menu-template.php
免责声明:本站资源来自互联网收集,仅供用于学习和交流,请遵循相关法律法规,本站一切资源不代表本站立场,如有侵权、后门、不妥请联系本站删除!
更新日志
- 原神恰斯卡最强深渊阵容搭配推荐
- 盛惠决战双十一降临《坦克世界》
- 最终幻想1411月12日更新公告:7.05版本正式上线
- 守望先锋2经典6v6模式限时回归
- 康康《自由如风6N纯银SQCD》[WAV+CUE]
- 傅薇1991-迷雾中共舞[歌林][WAV+CUE]
- 王菲《菲故事6N纯银SQCD》WAV+CUE
- 群星.1996-宝丽金笑傲江湖精丫宝丽金】【WAV+CUE】
- 好日.2024-好日HoNi【风潮】【FLAC分轨】
- 陈文媛.2001-GRACEFUL【东方魅力】【WAV+CUE】
- 群星《音乐磁场02》国语经典名曲系列[低速原抓WAV+CUE][620M]
- 群星 -《2024好听新歌21》十倍音质 [WAV+分轨][991M]
- 群星 《2015香港高级视听展原音精选》SACD非卖品[WAV+CUE][1.2G]
- 英雄联盟双城之战第2季几点播出 双城之战第2季播出时间介绍
- 宝可梦大集结国服几点可以下载公测 大集结公测时间一览