说明
创建用户的下拉式菜单HTML文本。
用法
<?php wp_dropdown_users( $args ); ?>
默认用法
<?php $args = array(
'show_option_all' => ,
'show_option_none' => ,
'orderby' => 'display_name',
'order' => 'ASC',
'include' => ,
'exclude' => ,
'multi' => 0,
'show' => 'display_name',
'echo' => 1,
'selected' => 0,
'name' => 'user',
'class' => ); ?>
参数
show_option_all
（字符串）生成下拉式选项框的HTML，从而允许你选定所有用户。
show_option_none
（字符串）生成下拉式选项框的HTML，从而允许你不选定任何用户。
orderby
（字符串）按某种标准为用户排序。有效值包括：
- 'ID'
- 'user_nicename'
- 'display_name' ——默认值
order
（字符串）为分类目录排序（升序或降序）有效值包括：
- 'ASC'（升序） ——默认值
- 'DESC'（降序）
include
（字符串）被包含的用户的ID列表，各ID用逗号隔开，例如， 'include=4,12' 表示显示或返回ID为4和12的用户。默认值为包含所有用户。
exclude
（字符串）将要排除的用户的ID列表，各ID用逗号隔开。例如， 'exclude=4,12' 表示不显示或返回ID为4和12的用户。默认值为不排除任何用户。
multi
（布尔型）是否剥离'select'元素的ID属性。
- 1 （true）
- 0（false）——默认值
show
（字符串）将要显示的用户表。如果选定的列表项为空，user_login会显示在括号中。
- 'ID'
- 'user_nicename'
- 'display_name' ——默认值
echo
（布尔型）显示结果（TRUE），或返回结果以供PHP使用（FALSE）
- 1 （true）——默认值
- 0（false）
selected
（整数）在显示框中选中/显示的用户的ID。默认为不选中任何用户。
name
（字符串）下拉式选框被赋予的名称。默认为user'。
class
（字符串）被赋给下拉式选项框的类。
示例
带有提交按钮的下拉式选项框
以HTML格式显示一个带有有提交按钮的用户下拉式列表。
<li id="users">
<h2><?php _e('users:'); ?></h2>
<form action="<?php bloginfo('url'); ?>" method="get">
<?php wp_dropdown_users(); ?>
<input type="submit" name="submit" value="view" />
</form>
</li>
历史记录
- 始见于WordPress 2.3.0版本
源文件
wp_dropdown_users()位于wp-includes/user.php
分类：中文手册