wp_dropdown_categories 创建分类目录下拉选项表单
文 / @UTHEME
函数描述
显示一个目录下拉选择表单元素。
使用方法
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 | 整数 |
相关文章
|