当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(誤字 "theme_locaton" (iが抜けている) の修正)
(説明)
8行目: 8行目:
 
このタグは、ナビゲーションメニューを表示します。メニューは管理画面 [[管理パネル#Appearance|Appearance]] > [[Appearance Menus SubPanel|Menus]] で作成できます。<!-- 要確認 --~~~~ -->
 
このタグは、ナビゲーションメニューを表示します。メニューは管理画面 [[管理パネル#Appearance|Appearance]] > [[Appearance Menus SubPanel|Menus]] で作成できます。<!-- 要確認 --~~~~ -->
  
 +
<tt>theme_location</tt>パラメーターが与えられた時、このタグはロケーションに割り当てられたメニューを表示します。もしロケーションがない場合、またはメニューが割り当てられていない場合は表示されません。
 +
 +
<tt>theme_location</tt>パラメーターが与えられなかった場合、このタグは以下を表示します。
 +
 +
*  <tt>menu</tt>パラメーターの値が最低1つでもある場合、そのメニューに一致するID, slug, あるいは名前;
 +
*  さもなくば、最初の空でないメニュー;
 +
*  さもなくば、<tt>fallback_cb</tt>パラメーターで与えられたタグの出力(デフォルトでは<tt>wp_page_menu()</tt>);
 +
*  さもなくば、何も表示しない。
 +
 +
'''Note:''' [[Version_3.5|WordPress 3.5]]に於いて、メニューアイテムがない場合は、HTMLマークアップはなにも出力されなくなりました。
 
<div id="Usage">
 
<div id="Usage">
 +
 
== 使い方 ==
 
== 使い方 ==
 
</div>
 
</div>

2013年5月26日 (日) 15:43時点における版

このページ「テンプレートタグ/wp nav menu」は情報が古くなっている可能性があります。最新版英語)も合わせてご覧ください。翻訳にご協力くださる方はぜひご相談ください

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

theme_locationパラメーターが与えられた時、このタグはロケーションに割り当てられたメニューを表示します。もしロケーションがない場合、またはメニューが割り当てられていない場合は表示されません。

theme_locationパラメーターが与えられなかった場合、このタグは以下を表示します。

  • menuパラメーターの値が最低1つでもある場合、そのメニューに一致するID, slug, あるいは名前;
  • さもなくば、最初の空でないメニュー;
  • さもなくば、fallback_cbパラメーターで与えられたタグの出力(デフォルトではwp_page_menu());
  • さもなくば、何も表示しない。

Note: WordPress 3.5に於いて、メニューアイテムがない場合は、HTMLマークアップはなにも出力されなくなりました。

使い方

<?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_location
文字列) (オプション) テーマ内で使用する場所。ユーザーが選択できるようにするには、register_nav_menu() で登録する必要がある。
初期値: なし

用例

デフォルトの用例

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

指定したメニューに絞り込む

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

Twenty Tenテーマで使用する

<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 にあります。

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

関数リファレンステンプレートタグ目次もご覧ください。