确定边栏是否正在使用中。

原型

is_active_sidebar( string|int $index )

描述

有关此功能和类似主题功能的更多信息,请查看Theme Developer Handbook中的Conditional Tags文章。

参数

$index (string|int) (Required) 边栏名称,ID或要检查的号码。

返回值

(bool)  如果侧边栏正在使用,则为true,否则为false。

源文件

路径:wp-includes/widgets.php

<?php
...
function is_active_sidebar( $index ) {
	$index = ( is_int($index) ) ? "sidebar-$index" : sanitize_title($index);
	$sidebars_widgets = wp_get_sidebars_widgets();
	$is_active_sidebar = ! empty( $sidebars_widgets[$index] );
	/**
	 * Filters whether a dynamic sidebar is considered "active".
	 *
	 * @since 3.9.0
	 *
	 * @param bool       $is_active_sidebar Whether or not the sidebar should be considered "active".
	 *                                      In other words, whether the sidebar contains any widgets.
	 * @param int|string $index             Index, name, or ID of the dynamic sidebar.
	 */
	return apply_filters( 'is_active_sidebar', $is_active_sidebar, $index );
}
...
?>

其他

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