「テンプレートタグ/wp nav menu」の版間の差分

2010年9月15日 (水) 21:16時点における版

このタグは、ナビゲーションメニューを表示します。メニューは管理画面 Appearance > Menus で作成できます。

<?php wp_nav_menu($args); ?> 

$menu

（文字列） （オプション） 望ましいメニュー。 id, slug, name をこの順で受け入れる。

初期値： なし

$container

（文字列） （オプション） ul をラップするか、ラップする場合は何でラップするか

初期値： div

$container_class

（文字列） （オプション） コンテナに適用されるクラス名

初期値： menu-{menu slug}-container

$container_id

（文字列） （オプション） コンテナに適用されるID

初期値： なし

$menu_class

（文字列） （オプション） メニューを構成する ul 要素に適用するCSS クラス名。

初期値： menu

$menu_id

（文字列） （オプション） メニューを構成する ul 要素に適用するID。

初期値： menu slug(順に増加)

$echo

（真偽値） （オプション） メニューをHTML出力する(true)か、PHPの値で返す(false)か

初期値： true

$fallback_cb

（文字列） （オプション） メニューが存在しない場合にコールバック関数を呼び出す

初期値： wp_page_menu

$before

（文字列） （オプション） リンクテキストの前のテキスト

初期値： なし

$after

（文字列） （オプション） リンクテキストの後のテキスト

初期値： なし

$link_before

（文字列） （オプション） リンクの前のテキスト

初期値： なし

$link_after

（文字列） （オプション） リンクの後のテキスト

初期値： なし

$depth

（整数） （オプション） 何階層まで表示するか。0 は全階層。

初期値： 0

$walker

（文字列） （オプション） Custom walker to use

初期値： なし

$theme_locaton

（文字列） （オプション） テーマ内で使用する場所。ユーザーが選択できるようにするには、register_nav_menu() で登録する必要がある。

初期値： なし

<div class="access">
  <?php wp_nav_menu(); ?>
</div>

<?php wp_nav_menu( array('menu' => 'Project Nav' )); ?>

<div id="access" role="navigation">
  <?php /*  Allow screen readers / text browsers to skip the navigation menu and get right to the good stuff */ ?>
	<div class="skip-link screen-reader-text"><a href="#content" title="<?php esc_attr_e( 'Skip to content', 'twentyten' ); ?>">
                 <?php _e( 'Skip to content', 'twentyten' ); ?></a></div>
	<?php /* Our navigation menu.  If one isn't filled out, wp_nav_menu falls back to wp_page_menu.  The menu assiged to the primary position is 
                 the one used.  If none is assigned, the menu with the lowest ID is used.  */ ?>
	<?php wp_nav_menu( array( 'container_class' => 'menu-header', 'theme_location' => 'primary' ) ); ?>
</div><!-- #access -->

更新履歴

3.0 で導入

wp_nav_menu() は wp-includes/nav-menu-template.php にあります。

• How to add navigation menus to existing themes and preserve backward compatibility

最新英語版： WordPress Codex » Function Reference/wp_nav_menu （最新版との差分）