在开发主题的时候,我们可能会使用到侧边栏这种布局方式,让我们的布局更加灵活多变,使用is_active_sidebar函数判断小工具是否使用,可以帮助我们根据不同情况实现不同显示效果。今天讲讲判断侧边栏小工具是否使用WordPress函数is_active_sidebar。
is_active_sidebar( string|int $index )
官方描述:判断侧边栏小工具是否使用
参数:
$index
(string|int) (必须) 侧边栏的名称、id、或者数字检查
返回值:
(bool) 如果正在使用返回true,否则返回false
函数原型
该函数位于wp-includes/widgets.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 );
}
简单使用
<?php if(is_active_sidebar('left-sidebar')){ ?>
<ul id="sidebar">
<?php dynamic_sidebar('left-sidebar'); ?>
</ul>
<?php }else{ ?>
<div class="textwidget">
<p>广告位待租!</p>
</div>
<?php } ?>
发表评论