函数原型
parent_dropdown( int $default_page, int $parent_page, int $level, int|WP_Post $post = null ): void|false
函数描述
Prints out option HTML elements for the page parents drop-down.
是否弃用
未弃用
函数参数
-
$default_page
int
Optional - The default page ID to be pre-selected. Default 0.
-
$parent_page
int
Optional - The parent page ID. Default 0.
-
$level
int
Optional - Page depth level. Default 0.
-
$post
int|WP_Post
Optional - Post ID or WP_Post object.
Default:
null
函数返回值
void|false Void on success, false if the page has no children.
函数位置
File: wp-admin/includes/template.php.
函数源码
function parent_dropdown( $default_page = 0, $parent_page = 0, $level = 0, $post = null ) {
global $wpdb;
$post = get_post( $post );
$items = $wpdb->get_results(
$wpdb->prepare(
"SELECT ID, post_parent, post_title
FROM $wpdb->posts
WHERE post_parent = %d AND post_type = 'page'
ORDER BY menu_order",
$parent_page
)
);
if ( $items ) {
foreach ( $items as $item ) {
// A page cannot be its own parent.
if ( $post && $post->ID && (int) $item->ID === $post->ID ) {
continue;
}
$pad = str_repeat( ' ', $level * 3 );
$selected = selected( $default_page, $item->ID, false );
echo "\n\t<option class='level-$level' value='$item->ID' $selected>$pad " . esc_html( $item->post_title ) . '</option>';
parent_dropdown( $default_page, $item->ID, $level + 1 );
}
} else {
return false;
}
}
源码链接
变更日志
| Version | Description |
|---|---|
| 4.4.0 | $post argument was added. |
| 1.5.0 | Introduced. |

