wordpress自定义菜单函数wp_nav_menu详解

最近在开发基于wordpress的企业类展示主题,经常用到菜单调用函数(wp_nav_menu),这里整理一下分享给大家。
1、函数介绍

wordpress在3.0版本之后新增了自定义菜单函数wp_nav_menu(),基于该函数的能力可使得wordpress能够自由轻松的调用自己制作的导航菜单

2、使用方法

在需要调用导航菜单(或者称之为自定义菜单)的地方插入<?php wp_nav_menu($args) ;?>来调用导航菜单,其中$args是函数的参数。

$args 参数详解

      $args = array(
        'theme_location'  => '',    
        // $theme_locaton:(字符串)(可选)
        // 说明:用于在调用导航菜单时指定注册过的某一个导航菜单名,如果没有指定,则显示第一个
        'menu'            => '',    
        // $menu:(字符串)(可选)
        // 说明:使用导航菜单的名称调用菜单,可以是 id, slug, name (按顺序匹配的) 
        'container'       => 'div', 
        // $container:(字符串)(可选)
        // 默认值: div
        // 说明:ul 父节点(这里指导航菜单的容器)的标签类型,只支持div 和 nav 标签。如果是其它值, ul 父节点的标签将不会被显示。也可以用false(container => false)去掉ul父节点标签。
        'container_class' => '',
        // $container_class:(字符串)(可选)
        // 默认值: menu-{menu slug}-container    
        // 说明:ul 父节点的 class 属性值。 默认
        'container_id'    => '',    
        // $container_id:(字符串)(可选)
        // 默认值: None
        // 说明:ul 父节点的 id 属性值。
        'menu_class'      => 'menu',
        // $menu_class:(字符串)(可选)
        // 默认值: menu
        // 说明:ul 节点的 class 属性值。
        'menu_id'         => '',    
        // $menu_id:(字符串)(可选)
        // 默认值: menu slug, 自增长的
        // 说明:ul 节点的 id 属性值。
        'echo'            => true,  
        // $echo:(布尔型)(可选)
        // 默认值: true (直接显示)
        // 说明:确定直接显示导航菜单还是返回 HTML 片段,如果想将导航的代码作为赋值使用,可设置为false。
        'fallback_cb'     => 'wp_page_menu', 
        // $fallback_cb:(字符串)(可选)
        // 默认值: wp_page_menu (显示页面列表作为菜单)
        // 用于没有在后台设置导航时调的回调函数。
        'before'          => '',    
        // $before:(字符串)(可选)
        // 默认值: None
        // 说明:显示在每个菜单链接前的文本。
        'after'           => '',    
        // $after:(字符串)(可选)
        // 默认值: None
        // 说明:显示在每个菜单链接后的文本。
        'link_before'     => '',    
        // $link_before:(字符串)(可选)
        // 默认值: None
        // 说明:显示在每个菜单链接文本前的文本。
        'link_after'      => '',   
        // $link_after:(字符串)(可选)
        // 默认值: None
        // 说明:显示在每个菜单链接文本后的文本。
        'items_wrap'      => '<ul id="%1$s" class="%2$s">%3$s</ul>',  
        // $items_wrap:(字符串)(可选)
        // 默认值: None
        // 说明:使用字符串替换修改ul的class。
        'depth'           => 0,     
        // $depth:(整型)(可选)
        // 默认值: 0
        // 显示菜单的深度, 当数值为 0 时显示所有深度的菜单。
        'walker'          => ''     
        // $walker:(对象型)(可选)
        // 默认值:  new Walker_Nav_Menu
      );
      wp_nav_menu($args); 

 


 

使用时则直接调用wp_nav_menu($args);就可以。

版权声明:小天 发表于 2021年10月9日 下午4:41。
转载请注明:wordpress自定义菜单函数wp_nav_menu详解 | 小菜IT

相关文章

暂无评论

暂无评论...