本地化
如何使用 GeoScene for JavaScript API 进行本地化?
API 将自动使用浏览器的语言环境。如果不希望使用该行为,可以在运行时将应用程序设置为特定的语言环境。执行此操作是通过 intl.setLocale(locale) 方法。
请注意,应用程序可以随时调用 setLocale
。微件将自动更改为新的语言环境。此行为被视为实验性行为,因为 API 不是围绕在运行时切换语言环境而设计的。例如,要素图层上的标注或由 Arcade 表达式格式化的数字和日期将不会更新。建议在应用程序中尽快调用 setLocale
。
也可以使用全局对象来初始化区域设置。
这种方法在 Dojo 配置对象中设置语言环境是首选方法。仍然向后兼容性,但不建议继续使用。
有关 API 本地化实用程序的更多信息,请参阅 Intl 模块 - 参考手册文档。
支持从右到左 (RTL)
GeoScene API for JavaScript 提供双向支持。要启用从右向左(RTL),请将 <html>
或 <body>
标记中的 dir
属性设置为 rtl
。
这将影响 API 的许多方面,例如:
- 微件内容。
- 主题。
- 默认 UI 组件(如放大/缩小微件)的位置。
- 使用 UI add/empty/move 方法的 leading/trailing 选项指定的微件位置。对于从左到右(LTR),“leading” 是左,“trailing” 是右。对于从右到左(RTL),”leading“ 表示右,”trailing“ 表示左。
或者,从右到左的 dir
属性可以单独应用于微件容器。然后,只有微件的内容会受到影响:
语言环境支持
适用于 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)