显示侧边栏的小部件及其设置。
原型
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/