当前浏览:首页 / WordPress函数 / _walk_bookmarks()

Alert: 此函数的访问被标记为私有。这意味着它不适用于插件或主题开发人员,只适用于其他核心函数。这里是出于完整性而列出。

_walk_bookmarks( array $bookmarks, string|array $args = '' ): string

bookmark列表的格式化输出

bookmark


描述

$bookmarks数组必须包含bookmark(书签)对象,并将迭代以检索要在输出中使用的书签。

输出格式为HTML,无法更改格式。然而,可以更改between、before和after的内容。链接本身将是HTML。

此函数由wp_list_bookmarks()内部使用,不应用于主题。


参数

$bookmarksarray必填
要遍历的书签列表。
$argsstring|array可选
书签参数.

  • show_updatedint|bool
    是否显示书签上次更新的时间。
    接受1|true0|false。默认0|false
  • show_descriptionint|bool
    是否显示书签描述。接受1|true0|false。默认0|false
  • show_imagesint|bool
    是否显示链接图像(如果可用)。接受1|true0|false。默认1|true
  • show_nameint|bool
    是否显示链接名称(如果可用)。接受1|true0|false。默认0|false
  • beforestring
    每个书签前的HTML或文本。默认<li>
  • afterstring
    要附加到每个书签的HTML或文本。默认</li>
  • link_beforestring
    锚(<a>)标签内每个书签的HTML或文本。
  • link_afterstring
    要附加到锚(<a>)标签内每个书签的HTML或文本。
  • betweenstring
    用于链接、描述和图像之间的字符串。
    默认值n。
  • show_ratingint|bool
    是否显示链接评级。接受1|true0|false
    默认0|false

默认:''


返回

string HTML格式的输出



源码

查看源码 官方文档


更新日志

版本描述
2.1.0开始引入