本地化

如何使用 GeoScene for JavaScript API 进行本地化？

API 将自动使用浏览器的语言环境。如果不希望使用该行为，可以在运行时将应用程序设置为特定的语言环境。自版本 4.16 开始，可通过 intl.setLocale(locale) 方法执行此操作。

代码块使用深色复制
// Sets the locale to French
intl.setLocale("fr");

// Sets the locale to UK English.
// Dates are formatted in day/month/year order.
intl.setLocale("en-GB");

// Sets the locale to US English.
// Dates are formatted in month/day/year order.
intl.setLocale("en-US"); 

请注意，应用程序可以随时调用 setLocale。微件将自动更改为新的语言环境。此行为被视为实验性行为，因为 API 不是围绕运行时切换语言环境而设计的。例如，要素图层上的标注或由 Arcade 表达式格式化的数字和日期将不会更新。建议在应用程序中尽快调用 setLocale。

区域设置仍然可以使用全局对象进行初始化，类似于 4.16 版本之前的处理方式。

代码块使用深色复制
<script>
  // Set the locale before the JSAPI loads
  geosceneConfig = {
    locale: "fr-FR"
  };
</script> 

在版本 4.16 之前，在 Dojo 配置对象中设置区域设置是首选方法。这仍然适用于向后兼容，但不建议继续使用。

有关 API 本地化实用程序的更多信息，请参阅 Intl 模块 - 参考手册文档。

支持从右到左（RTL）

GeoScene Maps SDK for JavaScript 提供双向支持。要启用从右向左（RTL），请将 <html> 或 <body> 标记中的 dir 属性设置为 rtl。

代码块使用深色复制
<html dir="rtl"> 

这将影响 API 的许多方面，例如：

微件内容。
主题。
使用 UI add/empty/move 方法的 leading/trailing 选项指定的微件位置。对于从左到右 (LTR)，"leading" 为左，"trailing" 为右。对于从右到左 (RTL)，"leading" 为右，"trailing" 为左。

或者，从右到左的 dir 属性可以单独应用于微件容器。然后，只有微件的内容会受到影响：

代码块使用深色复制
<body>
  <div id="viewDiv">
    <div id="elevationWidgetDiv" dir="rtl">
    </div>
  </div>
</body> 

语言环境支持

GeoScene Maps SDK for JavaScript 支持以下语言环境。

阿拉伯语 (ar)
波斯尼亚语 (bs) - 版本 4.2 中的新增内容
保加利亚语 (bg) - 版本 4.22 中的新增内容
加泰罗尼亚语 (ca) - 版本 4.8 中的新增内容
简体中文 (zh-cn)
繁体中文 (中国香港) (zh-hk)
繁体中文 (中国台湾) (zh-tw)
克罗地亚语 (hr) - 版本 4.1 中的新增内容
捷克语 (cs)
丹麦语 (da)
荷兰语 (nl)
英语 (en)
爱沙尼亚语 (et)
芬兰语 (fi)
法语 (fr)
德语 (de)
希腊语 (el)
希伯来语 (he)
匈牙利语 (hu) - 版本 4.8 中的新增内容
印度尼西亚语 (id) - 版本 4.2 中的新增内容
意大利语 (it)
日语 (ja)
韩语 (ko)
拉脱维亚语 (lv)
立陶宛语 (lt)
挪威语 (nb)
波兰语 (pl)
葡萄牙语 (巴西) (pt-br)
葡萄牙语 (葡萄牙) (pt-pt)
罗马尼亚语 (ro)
俄语 (ru)
塞尔维亚语 (sr) - 版本 4.1 中的新增内容
斯洛伐克语 (sk) - 版本 4.18 中的新增内容
斯洛文尼亚语 (sl) - 版本 4.6 中的新增内容
西班牙语 (es)
瑞典语 (sv)
泰语 (th)
土耳其语 (tr)
乌克兰语 (uk) - 版本 4.11 中的新增内容
越南语 (vi)