wordpress创建分类目录下拉表单函数:wp_dropdown_categories

2021年3月2日 飞飞 阅读(1.13K)
知识付费主题,优惠促销中:xx-blog主题

函数

wp_dropdown_categories( $args );

描述

显示一个目录下拉选择表单元素,函数直接返回html内容。

参数 $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',
];

参数详情

参数 数据类型 描述 默认值
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 整数 选择元素的制表符索引顺序 0
name 字符串 选择元素的「name」属性 cat
id 字符串 选择元素的「id」属性 cat
class 字符串 选择元素的「class」属性 postform
selected 整数|字符串 默认选择中选项 0
value_field 字符串 用于填充选项的分类字段,可以值有:’term_id’, ‘name’, ‘slug’, ‘term_group’, ‘term_taxonomy_id’, ‘taxonomy’, ‘description’, ‘parent’, ‘count’。 term_id
taxonomy 字符串 获取数据的分类法名称 category
hide_if_empty 布尔值 没有数据时,是否隐藏选择元素 false
required 布尔值 是否包含HTML5的「require」属性 false

 

使用例子

带提交按钮的下拉菜单

<li id="categories">
	<h2><?php _e( '分类目录:' ); ?></h2>
	<form id="category-select" class="category-select" action="<?php echo esc_url( home_url( '/' ) ); ?>" method="get">
	    <?php wp_dropdown_categories( 'show_count=1&hierarchical=1' ); ?>
	    <input type="submit" name="submit" value="view" />
	</form>
</li>


关注微信公众号『xx主题网

第一时间了解最新网络动态
关注博主不迷路~

未经允许不得转载:xx主题网 » wordpress创建分类目录下拉表单函数:wp_dropdown_categories
分享到:

评论抢沙发

要发表评论,您必须先

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏

扫码关注微信公众号

扫描关注xx主题网