wp_dropdown_categories 创建分类目录下拉选项表单

文 / @WordPress主题

函数描述

显示一个目录下拉选择表单元素。

使用方法

wp_dropdown_categories( $args );

默认使用

$args=[
'show_option_all'=>'',
'show_option_none'=>'',
'option_none_value'=>'-1',
'orderby'=>'ID',
'order'=>'ASC',
'show_count'=>0,
'hide_empty'=>1,
'child_of'=>0,
'exclude'=>'',
'echo'=>1,
'selected'=>0,
'hierarchical'=>0,
'name'=>'cat',
'id'=>'',
'class'=>'postform',
'depth'=>0,
'tab_index'=>0,
'taxonomy'=>'category',
'hide_if_empty'=>false,
'value_field'=>'term_id',
];

默认情况下,以上代码显示方法为:

  • 按分类id升序排列
  • 不显示分类中的文章数量
  • 不显示没有文章的分类目录
  • 不排除任何分类目录
  • 直接显示(echo)分类目录
  • 表单中没有选中任何分类目录
  • 不以分级结构显示分类目录
  • 分类‘cat’为下拉选择的表单名称
  • 分类表单css类‘postform’
  • 没有深度限制Nodepthlimit
  • Tabindex为0
  • 使用的分类方法为category
  • 如果没有分类项目隐藏下拉选择
  • 分局选择的分类项目输出分类id

参数

参数 数据类型 是否必需 描述 默认值
$args 字符串|数组 覆盖默认参数的数组或查询字符串

返回值

字符串,除非‘echo’参数设置为0,函数将直接显示HTML内容。

数组参数

参数 数据类型 描述 默认值
show_option_all 字符串 显示‘所有分类目录’选项的文本,下拉选项默认显示为‘所有分类目录
show_option_none 字符串 在下拉选择表单的顶部创建一个附加的<option>选项,以便不选择任何分类时使用。
option_none_value 字符串 选择分类的选项值 -1
orderby 字符串 用来给分类排序的数据列名称,可用的值为‘ID’,‘name’与‘slug’ ID
order 字符串 分类的排序方式,可用的值为‘ASC’和‘DESC’ ASC
pad_counts 布尔值 有关参数说明,请参见get_terms() false
show_count 布尔值|整数 是否包含分类中的文章数量,接受的值为0、1或对应的布尔值 0
echo 布尔值|整数 直接显示或返回生成的HTML,接受的值为0、1或对应的布尔值 0
hierarchical 布尔值|整数 是否显示为分层结构,接受的值为0、1或对应的布尔值 0
depth 整数 最大深度 0
tab_index 整数
添加UTHEME为好友
扫码添加UTHEME微信为好友
· 分享WordPress相关技术文章,主题上新与优惠动态早知道。
· 微信端最大WordPress社群,限时免费入群。