WordPress导航菜单函数 wp_nav_menu()

wp-includes/class-walker-nav-menu.php

wp-includes/nav-menu-template.php

function wp_nav_menu( $args = array() ) {
     static $menu_id_slugs = array();
     $defaults = array(
        'menu'            => '',    (调用指定ID、别名或名称的菜单)
        'container'       => 'div', (最外层容器标签名)
        'container_class' => '',    (最外层容器class名)
        'container_id'    => '',    (最外层容器id值)
        'menu_class'      => 'menu',(ul标签class)
        'menu_id'         => '',    (ul标签id)
        'echo'            => true,  (是否打印，默认是true，如果想将导航的代码作为赋值使用，可设置为false)          
        'fallback_cb'     => 'wp_page_menu',(备用的导航菜单函数，用于没有在后台设置导航时调用)
        'before'          => '',   (显示在导航a标签之前)
        'after'           => '',   (显示在导航a标签之后)
        'link_before'     => '',   (显示在导航链接名之后)
        'link_after'      => '',   (显示在导航链接名之前)
        'items_wrap'      => '<ul id="%1$s" class="%2$s">%3$s</ul>',(如何包装列表)
        'item_spacing'    => 'preserve',
        'depth'           => 0,    (显示的菜单层数，默认0，0是显示所有层)
        'walker'          => '',   (自定义walker)
        'theme_location'  => '',   (指定显示的导航名，如果没有设置，则显示第一个
     );
}

$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

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