函数描述
创建用户下拉选择菜单 HTML 元素。
使用方法
<?php wp_dropdown_users( $args ); ?>
默认使用
$args = [
'show_option_all' => null, // string
'show_option_none' => null, // string
'hide_if_only_one_author' => null, // string
'orderby' => 'display_name',
'order' => 'ASC',
'include' => null, // string
'exclude' => null, // string
'multi' => false,
'show' => 'display_name',
'echo' => true,
'selected' => false,
'include_selected' => false,
'name' => 'user', // string
'id' => null, // integer
'class' => null, // string
'blog_id' => $GLOBALS[ 'blog_id' ],
'who' => null // string
];
参数
show_option_all (string) 允许在下拉选项中选择所有用户。 show_option_none (string) 在下拉选择表单的顶部创建一个附加的<OPTION>选项,以便不选择任何用户时使用,次参数的值为实际的字符串,(如,设置此参数的值为 true,我们在下拉选项中看到的值将会是1。 orderby (string) 排列选项的key,可用的值有:
- ‘ID’
- ‘user_nicename’
- ‘display_name’ – 默认为此项
order (string) 排序方式,可用的值有:
- ‘ASC’ – 默认
- ‘DESC’
include (string) 逗号分隔的需要包含的用户id列表,如’include=4,12′ 是指用户id为 4 a和 12 的用户将被返回或显示,默认包含所有用户。 exclude (string)逗号分隔的需要排除的用户id列表,如’include=4,12′ 是指用户id为 4 a和 12 的用户将不被返回或显示,默认不排除任何用户。 multi (boolean) 是否在‘select’元素上跳过ID属性。
- 1 (True)
- 0 (False) – 默认
show (string) 需要显示的用户数据列,如果selected为空,将使用 user_login显示。
- ‘ID’
- ‘user_login’
- ‘display_name’ – Default
echo (boolean) 直接显示用户 (TRUE),还是返回他们以便在PHP中使用 (FALSE).
- 1 (True) – 默认
- 0 (False)
selected (integer) 默认选中的用户ID,默认没有选中任何用户。 include_selected (boolean) 总是在下拉选择中包含已经选中的用户名,默认为 false。 name (string) 分配给下拉表单的名称,默认为 ‘user’. class (string) 分配给下拉表单的css class。 id 下拉选项的ID 属性,默认为‘name’ 参数。 class 下拉选项的CSS Class属性。 blog_id 博客ID (在多站点中使用),默认id为当前博客。 who 查询哪个用户,目前只支持‘author’,默认为所有用户,在WordPress3.1版本中添加。
使用示例
带提交按钮的下拉选择表单
显示一个带提交按钮的下拉选择表单。
<li id="users">
<h2><?php _e('users:'); ?></h2>
<form action="<?php bloginfo('url'); ?>" method="get">
<?php wp_dropdown_users(array('name' => 'author')); ?>
<input type="submit" name="submit" value="view" />
</form>
</li>