显示侧边栏的小部件及其设置。

原型

wp_list_widget_controls( string $sidebar, string $sidebar_name = '' )

描述

用于管理窗口小部件配置屏幕。

参数

$sidebar (string) (Required) 边栏ID。

$sidebar_name (string) (Optional)  边栏名称。

源文件

路径:wp-admin/includes/widgets.php

<?php
...
function wp_list_widget_controls( $sidebar, $sidebar_name = '' ) {
	add_filter( 'dynamic_sidebar_params', 'wp_list_widget_controls_dynamic_sidebar' );
	$description = wp_sidebar_description( $sidebar );
	echo '<div id="' . esc_attr( $sidebar ) . '" class="widgets-sortables">';
	if ( $sidebar_name ) {
		?>
		<div class="sidebar-name">
			<button type="button" class="handlediv hide-if-no-js" aria-expanded="true">
				<span class="screen-reader-text"><?php echo esc_html( $sidebar_name ); ?></span>
				<span class="toggle-indicator" aria-hidden="true"></span>
			</button>
			<h2><?php echo esc_html( $sidebar_name ); ?> <span class="spinner"></span></h2>
		</div>
		<?php
	}
	if ( ! empty( $description ) ) {
		?>
		<div class="sidebar-description">
			<p class="description"><?php echo $description; ?></p>
		</div>
		<?php
	}
	dynamic_sidebar( $sidebar );
	echo '</div>';
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/wp_list_widget_controls/