记录成长
分享快乐

WordPress学习——wp_enqueue_script()详解

wp_enqueue_script() 作为向 WordPress 主题页面中引入脚本文件的最佳方法,可以有效地避免在多个代码块中重复调用脚本文件的问题。该函数一般与 wp_register_script() 函数一同使用,如果我们已经通过 wp_register_script() 注册了一个脚本,那么直接使用该函数引入即可;如果未使用 wp_register_script() 注册,该函数也支持相应参数定义。简单来说,如果你注册并需要立即引入脚本文件的话直接使用 wp_enqueue_script() 即可;如果你需要注册脚本又不确定何时引入的话则需要先使用 wp_register_script() 注册,然后在需要引入的时候通过 wp_enqueue_script() 引入即可。该函数语法如下所示:

wp_enqueue_script( string $handlestring $src = ''array $deps = array(),string|bool|null $ver = falsebool $in_footer = false )

$handle:字符串(必填)。脚本名称,必须是唯一值。

$src:字符串或布尔值(可选)。完整的脚本文件路径或基于WordPress根目录的相对路径。如果资源为false,则脚本为基于其他脚本的别名。

$deps:数组(可选)。脚本将在该数组所包含的其他脚本之后处理。

$ver:字符串、布尔值或空值(可选)。指定脚本版本号,将其作为查询字符串添加到 URL 中以清除缓存。 如果设置为 false ,则自动设置当前安装的 WordPress 版本为版本号。 如果设置为 null ,则不添加任何版本。

$in_footer:布尔值(可选)。是否在 body 标签之前加载,而不是在 head 中加载。

注意:使用该函数则必须使用 <?php wp_head();?><?php wp_footer();?> 获取页眉页脚,否则脚本文件将无法引入!!!

该函数定义在 wp-includes/functions.wp-scripts.php 文件中,具体代码如下:

function wp_enqueue_script( $handle, $src = '', $deps = array(), $ver = false, $in_footer = false ) {
	$wp_scripts = wp_scripts();

	_wp_scripts_maybe_doing_it_wrong( __FUNCTION__ );


	if ( $src || $in_footer ) {
		$_handle = explode( '?', $handle );

		if ( $src ) {
			$wp_scripts->add( $_handle[0], $src, $deps, $ver );
		}

		if ( $in_footer ) {
			$wp_scripts->add_data( $_handle[0], 'group', 1 );
		}
	}

	$wp_scripts->enqueue( $handle );
}

参考文档:https://developer.wordpress.org/reference/functions/wp_enqueue_script/

历史上的今天:

哇哦~~~,历史上的今天没发表过文章哦
赞(0) 我要打赏
蝈蝈提醒:转载请注明出处哦>>>蝈蝈要安静 » WordPress学习——wp_enqueue_script()详解
分享到: 更多 (0)

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址

博客文章有用,赏博主一包辣条~~~

支付宝扫一扫打赏

微信扫一扫打赏

WordPress学习——wp_enqueue_script()详解-海报

分享本文封面