wordpress 自定义友情链接菜单

1083

在任意位置添加自定义菜单展示列表,使用wp_nav_menu来进行

使用函数

wp_nav_menu( array $args = array() ): void|string|false

函数字段

  • $args
字段 类型 描述
menu int 想要的菜单。接受菜单 ID、slug、名称或对象。
menu_class string 用于形成菜单的ul元素的CSS类。默认为 ‘menu’。
menu_id string 应用于形成菜单的ul元素的ID。默认为菜单slug,递增。
container string 是否包裹ul,以及使用什么来包裹它。默认为 ‘div’。
container_class string 应用于容器的类。默认为 ‘menu-{menu slug}-container’。
container_id string 应用于容器的ID。
container_aria_label string 当容器是nav元素时应用的aria-label属性。
fallback_cb callable 如果菜单不存在,则会触发回调函数。
默认为'wp_page_menu'. 设置为 false 则无回退。
before string 链接标记之前的文本。
after string 链接标记之后的文本。
link_before string 链接文本之前的文本。
link_after string 链接文本之后的文本。
echo bool 是否回显菜单或返回菜单。默认为true。
depth int 包含层次结构的级别有多少。0表示全部。默认为0。
walker object 自定义walker类的实例。
theme_location string 要使用的主题位置。必须在register_nav_menu()中注册,以便用户选择。
items_wrap string 应该如何包装列表项。使用printf()格式,带有编号的占位符。默认为具有id和class的ul。
item_spacing string 是否在菜单的HTML中保留空格。接受 ‘preserve’ 或 ‘discard’。默认为 ‘preserve’。

例子

<div class="links_box">
	<span>友情链接>></span>
	<?php
	wp_nav_menu( array(
		'container'      => false,           // 不包裹在最外层容器中
		'theme_location' => 'links',         // 调用名为'links'的菜单
		'depth'          => 0,               // 菜单深度
		'menu_class'     => 'links',         // ul父节点class值
	) );
	?>
</div>