Виджет Переключатель языка

Виджет Переключатель языка представляет собой ниспадающее меню, которое позволяет переключать язык приложения во время выполнения.

В общих настройках вы можете указать перевод текстовых ресурсов приложения. Все языки, добавленные в окне Управление переводами, автоматически отображаются в качестве пунктов меню в виджете Переключатель языка.

Виджет Переключатель языка может обновлять следующие два типа текста приложения:

  • Текст, созданный в приложении — любой текстовый ресурс приложения, который вы вводите вручную. Сюда входят, помимо прочего, текст виджет Текст, текст виджет Кнопка, названия виджетов, названия страниц и альтернативный текст виджет Изображение.
  • Esri-предоставленный текст — встроенный текст интерфейса приложения, который нельзя настроить, например, названия инструментов и всплывающие подсказки.

Список поддерживаемых языков отображается в окне Управлять переводом. Языки подразделяются на две категории: С полной поддержкой и С частичной поддержкой. Для языков с полной поддержкой поддерживается перевод как текста, созданного приложением, так и Esri-предоставленного текста. Для языков с частичной поддержкой поддерживается перевод только текста, создаваемого в приложении.

Примечание:

Виджет Переключатель языка не влияет на текст в картографических данных, например, на текст в названиях слоев, надписях объектов и всплывающих окнах.

Примеры

Используйте этот виджет для поддержки требований к разработке приложений, таких как:

  • Вы хотите создать многоязычное приложение.
  • Вы хотите, чтобы пользователи могли переключаться между языками.
  • Вы хотите отобразить название текущего выбранного языка приложения.

Примечания по использованию

Для использования виджета Переключатель языка необходимо добавить как минимум один язык в окне Управление переводами в дополнение к языку по умолчанию.

Чтобы протестировать виджет Переключатель языка, необходимо предварительно просмотреть приложение в новом окне или запустить опубликованное приложение. Виджет не переключает языки в среде конструктора.

Настройки

Виджет Переключатель языка содержит следующие настройки:

  • Стиль - выберите один из следующих стилей пользовательского интерфейса:
    • Ниспадающее меню — виджет, состоящий из значка и текстовой кнопки ниспадающего меню. Текст кнопки отображает текущий выбранный язык.
    • Значок — виджет представляет собой ниспадающее меню со значком.
  • Значок - измените значок виджета. Можно выбрать один из значков по умолчанию или загрузить свои собственные значки.

Параметры URL

Параметры URL добавляют к URL-адресу информацию о приложении. Для создания URL-адреса, открывающего ваше приложение на определенном языке, можно использовать параметр URL locale, за которым следует двухбуквенный код языка ISO 639-1.

По умолчанию параметр locale и соответствующий код языка отображаются в URL-адресе приложения при переключении языка приложения с помощью виджета Переключатель языка. Включить или выключить это поведение можно с помощью параметра Язык в разделе Управление статусом URL-адресов.

ArcGIS Experience Builder поддерживает все те же языки, что и поддерживает ArcGIS Online.

Ниже приведён пример URL-адреса, который переключает язык приложения Experience Builder на французский:

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