register_nav_menus()（注冊(cè)菜單）
register_nav_menus() 函數(shù)用來注冊(cè)一個(gè)菜單，菜單指的是 WordPress 3.0+ 的菜單管理器，注冊(cè)之后用戶就可以在菜單管理器里拖動(dòng)生成導(dǎo)航菜單了。

用法

register_nav_menus( $locations );

參數(shù)

$locations

（數(shù)組）（必須）要注冊(cè)的菜單，鍵值為菜單 ID，鍵名為菜單名稱，可以一次創(chuàng)建多個(gè)。

默認(rèn)值：None

返回值

該函數(shù)無返回值。

例子

/**
  *建立菜單
  *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' );

其它

該函數(shù)位于：wp-includes/nav-menu.php

wp_nav_menu()（菜單調(diào)用）
下面就來說一下怎么調(diào)用用戶添加好后的菜單。

調(diào)用菜單主要使用 wp_nav_menu() 函數(shù)，wp_nav_menu() 函數(shù)的參數(shù)比較多，所以功能非常強(qiáng)大，這里會(huì)一個(gè)一個(gè)的講解。

用法

wp_nav_menu( $args );

參數(shù)

參數(shù)只有一個(gè) $args，但這是一個(gè)數(shù)組，通過給數(shù)組添加參數(shù)，可以定制更多細(xì)節(jié)，下邊是默認(rèn)值：

$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

（字符串）（可選）要調(diào)用的菜單的名字，比如 header_menu，如果沒指定，則默認(rèn)顯示第一個(gè)注冊(cè)的菜單。

默認(rèn)值：None

menu

（字符串）（可選）使用導(dǎo)航菜單的名稱調(diào)用菜單，可以是 ID、別名和名字（按順序匹配）。

默認(rèn)值：None

container

（字符串）（可選）導(dǎo)航菜單的容器類型，只支持 div 和 nav 標(biāo)簽，如果是其它值，ul 父節(jié)點(diǎn)的標(biāo)簽將不會(huì)顯示。也可以設(shè)置成 False 去掉 ul 父節(jié)點(diǎn)。

默認(rèn)值：div

container_class

（字符串）（可選）ul 父節(jié)點(diǎn)的 class 屬性。

默認(rèn)值：menu-{menu slug}-container

container_id

（字符串）（可選）ul 父節(jié)點(diǎn)的 id 屬性。

默認(rèn)值：None

menu_class

（字符串）（可選）ul 節(jié)點(diǎn)的 class 屬性。

默認(rèn)值：None

menu_id

（字符串）（可選）ul 節(jié)點(diǎn)的 id 屬性。

默認(rèn)值：菜單別名

echo

（布爾）（可選）返回導(dǎo)航菜單的 Html 代碼還是直接打印輸出，如果你想把導(dǎo)航菜單代碼存到變量里請(qǐng)?jiān)O(shè)置成 False.

默認(rèn)值：True（直接打印輸出）

fallback_cb

（回調(diào)函數(shù)）（可選）后臺(tái)沒有設(shè)置此菜單時(shí)默認(rèn)顯示的內(nèi)容。

默認(rèn)值：wp_page_menu

before

（字符串）（可選）顯示在每個(gè)菜單鏈接前的文本。

默認(rèn)值：None

after

（字符串）（可選）顯示在每個(gè)菜單鏈接后的文本。

默認(rèn)值：None

link_before

（字符串）（可選）顯示在每個(gè)菜單鏈接文本前的文本。

默認(rèn)值：None

link_after

（字符串）（可選）顯示在每個(gè)菜單鏈接文本后的文本。

默認(rèn)值：None

items_wrap

（字符串）（可選）替換 ul 的 class 屬性。

默認(rèn)值：None

depth

（整形）（可選）

顯示菜單的深度，當(dāng)數(shù)值為 0 時(shí)顯示所有深度的菜單。

默認(rèn)值：0

walker

（對(duì)象）（可選）菜單的結(jié)構(gòu)對(duì)象。

默認(rèn)值：new Walker_Nav_Menu

例子

<?php wp_nav_menu( array( 'theme_location' => 'header_menu', 'container' => false, 'items_wrap' => '<ul id="topmenu">%3$s</ul>', 'fallback_cb' => 'Bing_menu_null_fallback' ) ); ?>

其它

此函數(shù)位于：wp-includes/nav-menu-template.php

最新評(píng)論