函数文档

enqueue_embed_scripts()

💡 云策文档标注

概述

enqueue_embed_scripts() 是一个 WordPress 函数,用于在嵌入 iframe 中排队加载默认的 CSS 和 JS 文件。它主要用于为旧版 IE 提供 PNG 回退支持,并允许插件通过 wp_enqueue_script() 添加脚本。

关键要点

  • 函数 enqueue_embed_scripts() 在 oembed_head() 中首先运行,负责为嵌入 iframe 排队脚本和样式。
  • 它触发一个 Hook:do_action('enqueue_embed_scripts'),允许插件在嵌入 iframe 中自定义脚本和样式。
  • 此函数从 WordPress 4.4.0 版本开始引入,主要用于处理旧版 IE 的 PNG 回退 CSS。

代码示例

function enqueue_embed_scripts() {
    /**
     * Fires when scripts and styles are enqueued for the embed iframe.
     *
     * @since 4.4.0
     */
    do_action( 'enqueue_embed_scripts' );
}

注意事项

此函数仅用于嵌入 iframe 上下文,开发者可以通过 Hook 'enqueue_embed_scripts' 添加自定义脚本或样式,但需确保兼容性。


📄 原文内容

Enqueues embed iframe default CSS and JS.

Description

Enqueue PNG fallback CSS for embed iframe for legacy versions of IE.

Allows plugins to queue scripts for the embed iframe end using wp_enqueue_script() .
Runs first in oembed_head().

Source

function enqueue_embed_scripts() {

	/**
	 * Fires when scripts and styles are enqueued for the embed iframe.
	 *
	 * @since 4.4.0
	 */
	do_action( 'enqueue_embed_scripts' );
}

Hooks

do_action( ‘enqueue_embed_scripts’ )

Fires when scripts and styles are enqueued for the embed iframe.

Changelog

Version Description
4.4.0 Introduced.