云策 WordPress 开发者社区

函数文档

wp_script_modules()

查看官方原文 ↗
💡 云策文档标注

概述

wp_script_modules() 函数用于获取或创建主 WP_Script_Modules 实例，确保在 WordPress 中管理脚本模块时有一个可用的全局实例。

关键要点

  • 函数返回 WP_Script_Modules 类的实例，用于处理脚本模块的注册、排队等操作。
  • 如果全局变量 $wp_script_modules 未实例化，函数会自动创建新的 WP_Script_Modules 实例。
  • 此函数从 WordPress 6.5.0 版本开始引入，是脚本模块系统的核心组成部分。

代码示例

function wp_script_modules(): WP_Script_Modules {
	global $wp_script_modules;

	if ( ! ( $wp_script_modules instanceof WP_Script_Modules ) ) {
		$wp_script_modules = new WP_Script_Modules();
	}

	return $wp_script_modules;
}
📄 原文内容

Retrieves the main WP_Script_Modules instance.

Description

This function provides access to the WP_Script_Modules instance, creating one if it doesn’t exist yet.

Return

WP_Script_Modules The main WP_Script_Modules instance.

Source

function wp_script_modules(): WP_Script_Modules {
	global $wp_script_modules;

	if ( ! ( $wp_script_modules instanceof WP_Script_Modules ) ) {
		$wp_script_modules = new WP_Script_Modules();
	}

	return $wp_script_modules;
}

View all references View on Trac View on GitHub

Used by Description
wp_deregister_script_module()wp-includes/script-modules.php

Deregisters the script module.
wp_register_script_module()wp-includes/script-modules.php

Registers the script module if no script module with that script module identifier has already been registered.
wp_enqueue_script_module()wp-includes/script-modules.php

Marks the script module to be enqueued in the page.
wp_dequeue_script_module()wp-includes/script-modules.php

Unmarks the script module so it is no longer enqueued in the page.
WP_Block::render()wp-includes/class-wp-block.php

Generates the render output for the block.

Changelog

Version Description
6.5.0 Introduced.