当前浏览:首页 / WordPress函数 / register_nav_menu()

register_nav_menu( string $location, string $description )

注册主题的导航菜单位置

menumore...

nav

registermore...


参数

$location

(string)(必填) 菜单位置标识符,类似一个slug。

$description

(string)(必填) 菜单位置的描述性文本。


更多信息

  • 有关一次创建多个菜单的信息,请参见register_nav_menus()
  • 此函数自动注册主题的自定义菜单支持,因此您需要调用add_theme_support( 'menus' );
  • 该函数实际上通过以下方式调用register_nav_menus()来工作:
    register_nav_menus( array( $location => $description ) );
    
  • 您可以使用wp_nav_menu()显示自定义菜单。


源码

查看源码 官方文档


更新日志

版本描述
3.0.0开始引入

使用示例

  • 示例1

    注册“primary”导航菜单示例

    <?php
    add_action( 'after_setup_theme', 'register_my_menu' );
    function register_my_menu() {
      register_nav_menu( 'primary', __( 'Primary Menu', 'theme-slug' ) );
    }
    ?>
    
  • 示例2

    注册导航菜单,扩展示例:

    add_action( 'after_setup_theme', 'register_primary_menu' );
    
    function register_primary_menu() {
    	register_nav_menu( 'primary', __( 'Primary Menu', 'theme-text-domain' ) );
    }