当前浏览:首页 / WordPress函数 / is_active_sidebar()

is_active_sidebar( string|int $index )

边栏是否包含小工具

active

is 条件判断more...

sidebar 侧边栏


描述

更多类似的主题函数信息,请查看主题开发手册中的条件标签文章。


参数

$index

(string|int) (必填) 要检查的边栏name、id或number


返回

(bool) 如果边栏有小工具,则为true,否则为false。



源码

查看源码 官方文档


更新日志

版本描述
2.8.0开始引入

使用示例

  • 示例1

    示例,取决于侧边栏是否处于活动状态,显示不同的输出。

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

    在描述中:“使用中” 表示边栏包含小工具。

    任何包含小工具的边栏都将返回TRUE,而任何不包含小工具的边栏都将返回FALSE。

  • 示例3

    请注意,如果在调用register_sidebar时未明确声明ID,并且仅当ID正好是sanitize_title($sidebar_name)的值时,您无法按边栏名称进行搜索。

    代码使用的简单方法(见上文)就是原因:

    $index = ( is_int($index) ) ? "sidebar-$index" : sanitize_title($index);