描述
可以使用$callback或$id_base,$id_base是扩展不带可选$widget_id参数的WP_Widget类时的第一个参数,返回第一个边栏的ID,其中找到具有给定回调或$id_base的小工具的第一个实例。使用$widget_id参数,返回边栏的ID,其中包含该callback/$id_base的小工具和该ID。
注意:$widget_id和$id_base对于单个小工具是相同的。为了有效,该函数必须在小工具初始化后,在动作‘init’或更高的时候运行。
更多类似的主题函数信息,请查看主题开发手册中的条件标签文章。
参数
- $callback
-
(callable|false)(可选) 小工具回调以检查。
默认值: false
- $widget_id
-
(string|false)(可选) 小工具ID。可选,但需要检查。
默认值: false
- $id_base
-
(string|false)(可选) 通过扩展WP_Widget创建的小工具的基本ID。
默认值: false
- $skip_inactive
-
(bool)(可选) 是否在'wp_inactive_widgets'中检查。
默认值: true
返回
(string|false) 小工具处于激活状态的边栏ID,如果小工具不处于激活状态,则为false。
源码
更新日志
版本 | 描述 |
---|---|
2.2.0 | 开始引入 |
使用示例
仅当小工具处于活动状态时加载脚本
<?php if ( is_active_widget( false, false, $this->id_base, true ) ) { wp_enqueue_script( 'jquery' ); } ?>