“语言切换器”微件

‌“语言切换器”微件是一个下拉菜单,用于在运行时切换应用程序语言‌。

常规设置中,可以为应用程序文本内容提供翻译。 在管理翻译窗口中添加的任何语言都会作为菜单选项自动显示在“语言切换器”微件中。

“语言切换器”微件可以更新以下两种类型的应用程序文本:

  • 应用程序创作的文本 - 手动输入的任何应用程序文本内容。 其中包括但不限于“文本”微件文本、“按钮”微件文本、微件名称、页面名称和“图像”微件替代文本。
  • Esri 提供的文本 - 无法自定义的内置应用程序界面文本,例如工具名称和工具提示。

受支持语言的列表会显示在管理翻译窗口中。 语言分为完全支持部分支持两类。 完全支持语言会翻译应用程序创作的文本和 Esri 提供的文本。 部分支持语言仅翻译应用程序创作的文本。

注:

“语言切换器”微件不会影响地图数据中的文本,例如图层名称、要素标注和弹出窗口信息中的文本。

示例

使用此微件可支持以下应用程序设计要求:

  • 您希望提供一款多语言应用程序。
  • 您希望用户能够在语言之间进行切换。
  • 您希望显示当前所选应用程序语言的名称。

用法说明

要使用“语言切换器”微件,除了默认语言之外,您还必须在管理翻译窗口中添加至少一种语言。

要测试“语言切换器”微件,您必须在新窗口中预览应用程序或者启动已发布应用程序。 该微件无法在构建器环境中切换语言。

设置

“语言切换器”微件包含以下设置:

  • 样式 - 选择以下用户界面样式之一:
    • 下拉菜单 - 该微件由一个图标和一个文本下拉按钮组成。 按钮文本显示了当前所选语言。
    • 图标 - 该微件是一个图标下拉按钮。
  • 图标 - 更改微件图标。 可从默认图标中进行选择或自行上传图标。

URL 参数

URL 参数用于将有关应用程序的信息添加至 URL。 可以使用 locale URL 参数,后跟一个双字母 ISO 639-1 语言代码来创建将以特定语言打开应用程序的 URL。

默认情况下,当您使用“语言切换器”微件切换应用程序语言时,locale 参数和关联的语言代码将显示在应用程序 URL 中。 可以在管理 URL 状态下的语言设置中启用或禁用此行为。

ArcGIS Experience Builder 支持 ArcGIS Online 所支持的所有相同语言

以下示例 URL 可将 Experience Builder 应用程序的语言切换为法语:

https://experience.arcgis.com/experience/<AppId>/?locale=fr