函数描述

创建用户下拉选择菜单 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>