WordPress函数：wp_localize_script（脚本本地化）

本文目录
[隐藏]

• 1说明
• 2用法
• 3参数
• 4示例
• 5源文件

说明

将已添加的脚本进行本地化（翻译）。当然也可用来在一个页面中包含任意的Javascript数据。

用法

1

<?php wp_localize_script( $handle, $object_name, $l10n ); ?>

<?php wp_localize_script( $handle, $object_name, $l10n ); ?>

参数

$handle

（字符串）（必填） 你所要附加数据的处理脚本

默认值：无

$object_name

（字符串）（必填） 将包含数据的脚本对象名称（也就是所要翻译文本的前缀）

默认值：无

$l10n

（数组）（必填）要本地化的数据本身。可以是单独的一个或者多个（WordPress 3.3+）二维数组。

默认值：无

示例

1
2
3
4
5

<?php
wp_enqueue_script( 'some_handle' );
$translation_array = array( 'some_string' => __( 'Some string to translate' ), 'a_value' => '10' );
wp_localize_script( 'some_handle', 'object_name', $translation_array );
?>

<?php wp_enqueue_script( ‘some_handle’ ); $translation_array = array( ‘some_string’ => __( ‘Some string to translate’ ), ‘a_value’ => ’10’ ); wp_localize_script( ‘some_handle’, ‘object_name’, $translation_array ); ?>

重要提示： wp_localize_script() 必须在所要附加数据的已进行排队或注册的脚本的后面调用。它不会将本地化数据附加给它后面的脚本文件。

你可以通过下面的方式访问脚本中的变量：

1
2
3

<script>
alert(object_name.some_string); // alerts 'Some string to translate'
</script>

<script> alert(object_name.some_string); // alerts ‘Some string to translate’ </script>

倡萌注：注意看本例的2段代码中的“object_name”“some_string”“Some string to translate”是一一对应的。这样你就该知道如何使用了。

更详细的示例，请阅读：如何本地化翻译 Javascript 中的字符串

注释：本地化数据将以文本的形式传递给JavaScript调用，如果你要传递整数，你必须使用JavaScript函数 parseInt() ：

1
2
3

<script>
FinalZoom = map.getBoundsZoomLevel(bounds)-parseInt(data.a_value); // Call a function that needs an int.
</script>

<script> FinalZoom = map.getBoundsZoomLevel(bounds)-parseInt(data.a_value); // Call a function that needs an int. </script>

源文件

• 原文：http://codex.wordpress.org/Function_Reference/wp_localize_script
• 编译：倡萌@WordPress大学