本地化

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

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

          
1
2
3
4
5
6
7
8
9
10
// 将语言环境设置为法语
intl.setLocale("fr");

// 将语言环境设置为英式英语。
//日期的格式为日/月/年。
intl.setLocale("en-GB");

// 将语言环境设置为美式英语。
// 日期的格式为月/日/年。
intl.setLocale("en-US");

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

也可以使用全局对象来初始化区域设置。

      
1
2
3
4
5
6
<script>
  // 在加载 JSAPI 之前设置语言环境
  geosceneConfig = {
    locale: "fr-FR"
  };
</script>

这种方法在 Dojo 配置对象中设置语言环境是首选方法。仍然向后兼容性,但不建议继续使用。

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

支持从右到左 (RTL)

GeoScene API for JavaScript 提供双向支持。要启用从右向左(RTL),请将 <html><body> 标记中的 dir 属性设置为 rtl

 
1
<html dir="rtl">

这将影响 API 的许多方面,例如:

  • 微件内容。
  • 主题。
  • 默认 UI 组件(如放大/缩小微件)的位置。
  • 使用 UI add/empty/move 方法的 leading/trailing 选项指定的微件位置。对于从左到右(LTR),“leading” 是左,“trailing” 是右。对于从右到左(RTL),”leading“ 表示右,”trailing“ 表示左。

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

      
1
2
3
4
5
6
<body>
  <div id="viewDiv">
    <div id="elevationWidgetDiv" dir="rtl">
    </div>
  </div>
</body>

语言环境支持

适用于 JavaScript 的 GeoScene API 支持以下语言环境。

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

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.