> WordPress开发手册 > is_active_widget

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



上一篇:
下一篇: