注册一个新脚本。
原型
wp_register_script( string $handle, string $src, array $deps = array(), string|bool|null $ver = false, bool $in_footer = false )
描述
使用wp_enqueue_script()函数注册稍后要排队的脚本。
参考:
- WP_Dependencies::add()
- WP_Dependencies::add_data()
参数
$handle
(string)
(Required)
脚本的名称。应该是独特的。
$src
(string)
(Required)
脚本的完整URL,或脚本相对于WordPress根目录的路径。
$deps
(array)
(Optional)
此脚本依赖的注册脚本数组。
$ver
(string|bool|null)
(Optional)
指定脚本版本号的字符串(如果有),作为查询字符串添加到URL以进行缓存清除。如果version设置为false,则自动添加的版本号等于当前安装的WordPress版本。如果设置为null,则不添加任何版本。
$in_footer
(bool)
(Optional)
是否在</ body>之前将脚本入队,而不是在中。默认为’false’。
返回值
(bool)
脚本是否已注册。成功时是真的,失败时是假的。
源文件
路径:wp-includes/functions.wp-scripts.php
<?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/