注册一个新脚本。

原型

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/