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

wp_terms_checklist( int $post_id, array|string $args = array() ): string

输出标有分类项(term)名称的复选框input元素的无序列表

checklist

term 分类项more...


描述

wp_category_checklist()的分类模式独立版本。


参数

$post_idint可选
文章ID,默认值为0。
$argsarray|string可选
用于生成分类项(term)列表的参数数组或字符串。

  • descendants_and_self int
    类别ID,将输出该类别本身及其后代。
    默认值0。
  • selected_cats int[]
    要标记为选中状态的类别ID数组。默认值为false。
  • popular_cats int[]
    类别ID数组,用于接受"popular-category"类
    默认值 false
  • walker Walker
    Walker对象用于构建输出。默认为空,导致使用Walker_Category_Checklist实例。
  • taxonomy string
    要为其生成复选框列表的分类模式。默认'category'
  • checked_ontop bool
    是否将选中状态的项目移出层次结构并移至列表顶部。默认为true。
  • echo bool
    是否回显生成的标记。false返回标记,而不回显。默认值为true。

默认:array()


返回

string input元素的HTML列表。


钩子



源码

查看源码 官方文档


更新日志

版本描述
4.4.0引入了$echo参数。
3.0.0开始引入

使用示例

  • 示例1

    请注意,如果不允许当前用户分配分类项,则表单中的复选框将被禁用。此函数适用于面向管理员的列表。此外,此函数并不总是定义的。您可以使用

    include ABSPATH . 'wp-admin/includes/template.php';

    以确保函数已定义。