WordPress 教程:使用 wp_localize_script 从 PHP 传递参数给 JavaScript
WordPress 的 wp_localize_script
函数从它名字可以看出它是用来进行前端本地化的,它的工作方式是加载翻译之后的文本,接着将它们当做一个 JavaScript 对象输出到 HTML 中,然后 JS 脚本就用该对象去输出对应语言的文本了。
使用 wp_localize_script 从 PHP 传递参数给 JavaScript
但是我们使用 wp_localize_script
过程中,反而主要用来从 PHP 传递参数给 JavaScript,下面我通过微信机器人插件来讲讲如何使用该函数从 PHP 传递参数给 JavaScript。
微信公众平台在用户分享的时候可以让用自定义标题,摘要,图片和链接,我们需要把标题,摘要,图片和链接这些参数从 PHP 传递给 JavaScript,
首先使用 wp_enqueue_script
函数加载微信 JSSDK 的 jweixin.js 和我们自己写的 weixin.js:
wp_enqueue_script('jweixin', 'http://res.wx.qq.com/open/js/jweixin-1.0.0.js', array('jquery') );
wp_enqueue_script('weixin', WEIXIN_ROBOT_PLUGIN_URL.'/template/static/weixin.js', array('jweixin', 'jquery') );
然后我们可以把需要自定义的标题,摘要,图片和链接作为一个数组,
$weixin_data = array(
'img' => $img,
'link' => $link,
'title' => $title,
'desc' => $desc,
);
最后使用 wp_localize_script
将该变量传递给 JavaScript:
wp_localize_script('weixin', 'weixin_data', $weixin_data);
wp_localize_script
函数一共有三个参数:
- 第一个是:
$handle
,需把数据附加到脚本的 handle。 - 第二个是:
$object_name
,生成 JavaScript 对象名。 - 第三个是:
$data
,数据,可以文本,可以二位或者多维数组,会使用 json_encode 函数生成 JavaScript 的对象或者数据。
然后可以看到输出的结果:
/* */
这样就可以在 weixin.js 中使用 weixin_data 了。
将 wp_localize_script 从 PHP 传递给 JavaScript 的参数不编码成 unicode
但是从上面可以看到中文都编码成 unicode,虽然使用上没有什么问题,但是看起来总是不爽,有什么办法呢?
wp_localize_script
在最后 $data
参数中提供了一个叫做 l10n_print_after
的 key,它可以无任何干扰直接输出值,我们把 $data
参数,使用 json_encode 函数不编码成 unicode 方式放入 l10n_print_after
的 key 中,最后再传递给 wp_localize_script
即可:
$weixin_data = array(
'l10n_print_after' => 'weixin_data = ' . json_encode($weixin_data, JSON_UNESCAPED_UNICODE)
);
wp_localize_script( $handle, $object_name, $weixin_data );
最后输出的结果是:
/* */
看起来是不是清爽多了?