wp_register_script() 是 WordPress 用于注册一个新的脚本文件的函数。注册完成后我们可以使用 wp_enqueue_script() 函数挂载脚本。当然注册不是必须的,不过推荐大家使用。使用 wp_register_script() 可以有效地避免在多个代码块中重复调用脚本文件的问题。该函数的语法如下:
wp_register_script( string $handle, string|bool $src, array $deps = array(),string|bool|null $ver = false, bool $in_footer = false )
$handle:字符串(必填)。脚本名称,必须是唯一值。
$src:字符串或布尔值(必填)。完整的脚本文件路径或基于WordPress根目录的相对路径。如果资源为false,则脚本为基于其他脚本的别名。
$deps:数组(可选)。脚本将在该数组所包含的其他脚本之后处理。
$ver:字符串、布尔值或空值(可选)。指定脚本版本号,将其作为查询字符串添加到 URL 中以清除缓存。 如果设置为 false ,则自动设置当前安装的 WordPress 版本为版本号。 如果设置为 null ,则不添加任何版本。
$in_footer:布尔值(可选)。是否在 body 标签之前加载,而不是在 head 中加载。
该函数定义在 wp-includes/functions.wp-scripts.php 文件中,具体代码如下:
function wp_register_script( $handle, $src, $deps = array(), $ver = false, $in_footer = false ) { $wp_scripts = wp_scripts(); _wp_scripts_maybe_doing_it_wrong( __FUNCTION__ ); $registered = $wp_scripts->add( $handle, $src, $deps, $ver ); if ( $in_footer ) { $wp_scripts->add_data( $handle, 'group', 1 ); } return $registered; }
参考文档:https://developer.wordpress.org/reference/functions/wp_register_script/
评论 抢沙发