Question

wp_dropdown_roles( string $selected = '' )

Print out option html elements for role selectors.

---

description

---

参数

$selected

(string) (Optional) Slug for the role that should be already selected.

Default value: ''

---

源代码

File: wp-admin/includes/template.php

function wp_dropdown_roles( $selected = '' ) {
	$r = '';

	$editable_roles = array_reverse( get_editable_roles() );

	foreach ( $editable_roles as $role => $details ) {
		$name = translate_user_role($details['name'] );
		// preselect specified role
		if ( $selected == $role ) {
			$r .= "\n\t<option selected='selected' value='" . esc_attr( $role ) . "'>$name</option>";
		} else {
			$r .= "\n\t<option value='" . esc_attr( $role ) . "'>$name</option>";
		}
	}

	echo $r;
}

---

更新日志

Version	description
2.1.0	Introduced.

---

相关函数

Uses

• wp-admin/includes/user.php: get_editable_roles()
• wp-includes/l10n.php: translate_user_role()
• wp-includes/formatting.php: esc_attr()

---

Used By

• wp-admin/includes/class-wp-users-list-table.php: WP_Users_List_Table::extra_tablenav()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   Example

   If you would like to set a default role for the dropdown, provide the slug for the desired role as a parameter. The following example creates a dropdown of user roles with the “Editor” role as the default, selected value:

   
   <select>
      <?php wp_dropdown_roles( 'editor' ); ?>
   </select>