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/

未经允许不得转载

文章标题:蝈蝈要安静 » WordPress学习——wp_enqueue_script()详解

原文链接:https://blog.quietguoguo.com/3681.html

发布信息:文章由【蝈蝈要安静】于<2019-05-05>发布于【WP学习】分类下

相关标签:||

相关推荐

评论 抢沙发

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