描述
更多类似的主题函数信息,请查看主题开发手册中的条件标签文章。
参数
- $index
-
(string|int) (必填) 要检查的边栏name、id或number
返回
(bool) 如果边栏有小工具,则为true,否则为false。
源码
更新日志
版本 | 描述 |
---|---|
2.8.0 | 开始引入 |
使用示例
示例,取决于侧边栏是否处于活动状态,显示不同的输出。
<?php if ( is_active_sidebar( 'left-sidebar' ) ) { ?> <ul id="sidebar"> <?php dynamic_sidebar( 'left-sidebar' ); ?> </ul> <?php } ?>
在描述中:“使用中” 表示边栏包含小工具。
任何包含小工具的边栏都将返回TRUE,而任何不包含小工具的边栏都将返回FALSE。
请注意,如果在调用register_sidebar时未明确声明ID,并且仅当ID正好是
sanitize_title($sidebar_name)
的值时,您无法按边栏名称进行搜索。代码使用的简单方法(见上文)就是原因:
$index = ( is_int($index) ) ? "sidebar-$index" : sanitize_title($index);