2024年06月14日
WP関数:wp_nav_menu()
この関数の説明
WP関数の wp_nav_menu() は、ナビゲーションメニューを表示する関数です。
関数
wp_nav_menu( $args )
パラメータ
$args(配列)(オプション)
連想配列で表示するメニュの仕様を指定します。
指定しない場合は最初に作成されたメニュが呼び出されます。
<配列で指定できるキー>
指定できるキー | 説明 |
'theme_location' | ロケーション名で呼び出します。
ロケーション名はregister_nav_menu() で指定します。 指定した名前が無い場合は、固定ページ一覧がメニューになります。 |
'menu' | メニュ名で呼び出します。
指定した名前が無い場合は、1番目に作成されたメニュが呼ばれます。 |
'menu_class' | メニューの<ul>タグのクラス名を指定します。
初期値は 'menu' |
'menu_id' | メニューの<ul>タグのID名を指定します。
初期値は 'menu-メニュ名' |
■上記以外のキーは[テンプレートタグ/wp nav menu]を参照してください。
利用事例
①パラメータを指定しないケース
<div class="access">
<?php wp_nav_menu(); ?>
</div>
パラメータを指定していないので、最初に作られたメニュが表示されます。
②パラメータを指定した例
<?php $menu = ['theme_location' => 'main_menu']; wp_nav_menu( $menu ); ?>
上記は register_nav_menu() で「main_menu」が定義されている必要があります。
また、上記のメニュが設定されているか否かは has_nav_menu で確認できます。
関連情報
関連関数は メニュー関連関数 を参照してください。