wordpress 自定义友情链接菜单
在任意位置添加自定义菜单展示列表,使用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>