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 で確認できます。

 


関連情報

関連関数は メニュー関連関数 を参照してください。

 


関数一覧
  • 1.WPのエスケープ処理
  • 2.WPプログラムの基本
  • 3.ヘッダ/フッタ/サイドバで使われる関数
  • 4.DBからの読込関数
  • 5.一般テンプレートの中で使われる関数
  • 6.その他のWP関数
  • add_shortcode()
  • bloginfo()
  • body_class()
  • date_i18n()
  • dynamic_sidebar()
  • edit_post_link()
  • esc_attr()
  • esc_html_e()
  • esc_html()
  • esc_url()
  • get_ancestors()
  • get_cat_ID()
  • get_cat_name()
  • get_category_link()
  • get_category_parents()
  • get_category()
  • get_footer()
  • get_header()
  • get_home_url()
  • get_post_format()
  • get_post_meta()
  • get_post_thumbnail_id()
  • get_query_var()
  • get_search_query()
  • get_sidebar()
  • get_site_url()
  • get_stylesheet_directory_uri()
  • get_stylesheet_uri()
  • get_template_directory_uri()
  • get_template_part()
  • get_the_category()
  • get_the_content()
  • get_the_date()
  • get_the_excerpt()
  • get_the_ID()
  • get_the_modified_date()
  • get_the_modified_time()
  • get_the_permalink()
  • get_the_post_thumbnail()
  • get_the_tags()
  • get_the_time()
  • get_the_title()
  • get_uploaded_header_images()
  • get_year_link()
  • has_category()
  • has_custom_logo()
  • has_header_image()
  • has_header_video()
  • has_nav_menu()
  • has_post_thumbnail()
  • has_tag()
  • header_image()
  • home_url()
  • is_admin()
  • is_category()
  • is_date()
  • is_front_page()
  • is_home()
  • is_main_query()
  • is_page()
  • is_search()
  • is_single()
  • language_attributes()
  • the_category()
  • the_content()
  • the_custom_header_markup()
  • the_custom_logo()
  • the_date()
  • the_excerpt()
  • the_ID()
  • the_modified_date()
  • the_modified_time()
  • the_permalink()
  • the_post_thumbnail()
  • the_search_query()
  • the_tags()
  • the_time()
  • the_title()
  • update_post_meta()
  • wp_get_attachment_image_src()
  • wp_nav_menu()
  • WP_Query()