説明
パラメータ
- $args検索条件を指定する連想配列。キーワードは次の通り。
キーワード 省略時の値 意味 menu '' カスタムメニューのIDを指定 container 'div' ナビゲーションメニューを囲むタグ名を指定 container_class '' ナビゲーションメニューを囲むタグのクラス名を指定 container_id '' ナビゲーションメニューを囲むタグのIDを指定 menu_class 'menu' ナビゲーションメニューを囲むタグのクラス名を指定 menu_id '' ナビゲーションメニューを囲むタグのIDを指定 echo true ナビゲーションメニューを表示する場合はtrue、文字列として取得する場合はfalseを指定 fallback_cb 'wp_page_menu' メニューが存在しない場合に実行するコールバック関数名を指定(wp_page_menu) before '' メニューのリンク(aタグ)の前に出力する文字列を指定 after '' メニューのリンク(aタグ)の後に出力する文字列を指定 link_before '' メニューの文字列の前に出力する文字列を指定 link_after '' メニューの文字列の後に出力する文字列を指定 items_wrap '<ul id="%1$s" class="%2$s">%3$s</ul>' [3.1.0]メニューリストのパターンを指定 depth 0 階層数を指定(0はすべてを表示、1ならばメニューバーのみ)。 walker '' コールバック関数名を指定 theme_locaution '' テーマ内のロケーションIDを指定。
返り値
パラメータ'echo'がtrueの場合は何も返さない。パラメータ'echo'がfalseの場合はメニュータグの文字列を返す。注意
カスタムメニューを使用しない場合と使用する場合とでは、出力されるタグの構造が微妙に異なる。使用例
- ナビゲーションメニューを表示する。<?php wp_nav_menu( array( 'container_class' => 'menu-header', 'theme_locaution' => 'primary' ) ); ?>
- ナビゲーションメニューを取得する。<?php $nav = wp_nav_menu( array( 'container_class' => 'menu-header', 'theme_locaution' => 'primary', 'echo' => false ) ); ?>
フィルター
[3.0.0]受け取ったパラメータと標準値をマージ後、'wp_nav_menu_args'フィルターを呼び出す。パラメータ$argsには標準値とマージ済みの引数が格納された連想配列となる。アクション
実行するアクションはありません。ソースファイル
/wp-includes/nav-menu-template.php最終更新 : 2018年05月27日 10:49
関連
お勧め
サイトヘルス機能を使ってみた(2019年4月12日 更新)
先月末にWordPress 5.2 Beta1が、今日はWordPress 5.2 Beta2(以降5.2Beta2)が公開された。5.2ではブロックエディターの機能が強化され、サイトの安全性とパフォーマンス向上に役立つとされるサイトヘルス機能が追加される。
管理者ページに文言を表示する(2012年4月19日 更新)
お客様向けに管理者ページをカスタマイズする機会が増えてきている。カスタマイズするページや表示場所、表示内容によっていくつかの手段があるが、今回はページの冒頭部分に任意の文言を表示する方法を紹介する。WordPressのコーディングスタンダードとPSR-2がかみ合わない(2018年5月27日 更新)
先日パソコンのストレージを換装して開発環境を再構築。エディタのEclipseは「Neon(4.6)」から「Oxygen(4.7)」へ切り替わった。コードを書き始めるとそこはかとなく違和感があり、調べていくとPHPの「Code Style(Formatter)」が「PSR-2」に設定されていることが原因だった。
Widgets on dashboard:プラグイン作ってみました(2014年5月7日 更新)
サイトバーなどのページ構成パーツとしてウィジェットを利用し、ある程度頻繁に更新している場合、毎回ウィジェットページを表示するのはちょっとだけ面倒かも。そんなわけで、シンプルにダッシュボードで直接編集できればいいかなと思い、調べてみました。
5.7の機能拡張:投稿一覧画面向けのフィルター(2021年2月18日 更新)
昨日、予定通り公開された「WordPress 5.7 Beta 3(以降Beta 3)」。WordPressはバージョンアップ毎にアクションやフィルターが追加されており、今回のバージョンアップでは投稿一覧画面に影響を与えるフィルターが追加されていた。