is_active_widget

说明

is_active_widget() 是一个条件标签，用来检查是否小工具已经在前端显示（已使用）。只有在小工具初始化后，该函数才会生效。

用法

    <?PHP is_active_widget( $callback, $widget_id, $id_base, $skip_inactive ); ?>

参数

$callback

（字符串）（可选）小工具回调检查。

默认值：False

$widget_id

（整数）（可选）需要检查的小工具ID。

默认值：None

$id_base

（字符串）（可选）通过 WP_Widget 类扩展创建的小工具的基本ID。

默认值：None

$skip_inactive

（布尔）（可选）是否在 'wp_inactive_widgets' 中检查。

默认值：True

返回值

如果指定的小工具没有启用就返回 false，或者返回所启用的小工具所在的侧边栏的ID。如果回调不是唯一的，你可以指定小工具的ID。

示例

只有小工具启用才加载脚本

<?php
    if ( is_active_widget( false, false, $this->id_base, true ) ) {
    wp_enqueue_script( 'jquery' );
    }
    ?>

函数历史

始用于 WordPress 2.2.0 版本

源文件

is_active_widget() 位于 wp-includes/widgets.php