WordPress函数:is_active_sidebar 确定侧边栏是否包含小部件

江河/ 2023年09月15日/ WordPress/ 浏览 1216

函数原型:


is_active_sidebar( string|int $index ): bool


确定侧边栏是否包含小部件。


有关此主题函数和类似主题函数的更多信息,请参阅主题开发人员手册中的条件标记文章。


函数源码:


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 ] );

	return apply_filters( 'is_active_sidebar', $is_active_sidebar, $index );
}


包含钩子:


apply_filters( 'is_active_sidebar', bool $is_active_sidebar, int|string $index )


使用举例:


<?php if ( is_active_sidebar( 'left-sidebar' ) ) { ?>
	<ul id="sidebar">
		<?php dynamic_sidebar( 'left-sidebar' ); ?>
	</ul>
<?php } ?>


发表评论

暂无评论,抢个沙发...

客服 工单