wp_register_script()

wordpress函数 2015年08月28日 , ,

函数wp_register_script()是用来注册脚本文件,是一种安全的方式,注册后以便在wp_enqueue_script()函数中使用。http://furzoom.com/wp_register_script/

函数原型

wp_register_script($handle, $src, $deps, $ver, $in_footer);

参数详解

  1. $handle,脚本的名字。应当是唯一的,用于在整个系统中标识该脚本。
  2. $src,脚本的路径。对于本地的样式表不要使用硬编码,如http://furzoom.com/css/myscript.js,在插件中应该使用plugins_url(),在主题中应该使用get_template_directory_uri()来取得安全的路径。对于远程的脚本应该使用协议无关URL,如//deiio.com/css/script.js
  3. $deps,该脚本依赖的其他的脚本,应该事先加载所依赖的脚本。当该脚本使用函数wp_enqueue_script()调用时,其依赖的脚本会被自动的加载。参数形式为handle数组。默认为false。该参数可选。
  4. $ver,用于指定脚本的版本号的字符串。版本号将会作为查询字符串附加在脚本URL的后面,如?ver=4.3.0。默认值为false,将会添加WordPress的版本号。如果为null,则不添加使用字符。该参数可选。
  5. $in_footer,默认脚本将被添加到<head>部分。如果参数为true,脚本被加载到<body>标签底部。默认为false,该参数为可选。

返回值

该函数无返回值。

应用实例

使用下面的方式,脚本被会自己的加载:

// 使用下面的方式进行脚本的注册及入队
add_action('wp_enqueue_scripts', 'enqueue_and_register_my_scripts');

function enqueue_and_register_my_scripts() {
    // 注册脚本
    wp_register_script('my_plugin', plugins_url('my-plugin/js/my_script.js'));
    // 只在特定页面使用该脚本 
    if (is_page('careers')) {
        // 需要使用脚本依赖于上面注册的脚本及jQuery,则
        wp_enqueue_script('my-careers-script', plugins_url('my-pluing/js/my_careers_script.js', array('jquery', 'my_plugin'));
    }
}

 

总结

如果需要有前端使用该函数,需要使用wp_enqueue_scripts action来调用;如果要在后台管理页面使用则需要使用admin_enqueue_scripts action;如果要在登陆页面使用,则需要使用login_enqueue_scripts action。如果在不使用action调用会产生错误。

如果使用已经注册的handle来再次注册或者入队脚本,新的参数将被忽略。可以使用wp_deregister_script(),然后再次注册脚本。

wordpress本身已经注册过很多的脚本,具体可以查看http://codex.wordpress.org/Function_Reference/wp_register_script

如无特别说明,本站文章皆为原创,若要转载,务必请注明以下原文信息:
日志标题:《wp_register_script()》
日志链接:http://furzoom.com/wp_register_script/
博客名称:枫竹梦

【上一篇】
【下一篇】

发表评论

插入图片

NOTICE1:请申请gravatar头像,没有头像的评论可能不会被回复!

回到顶部