说明

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

分类：中文手册