Localização dos elementos da interface do usuário

Última atualização em 2023-11-03
  • Criado para:
  • Developer
    User

Determinado conteúdo que o Visualizador de imagem suspensa exibe está sujeito a localização. Esse conteúdo inclui dicas de ferramentas do elemento da interface do usuário e mensagens de informações exibidas pela exibição de zoom de imagem suspensa ao carregar.

Todo conteúdo textual no visualizador que pode ser localizado é representado pelo identificador especial do SDK do visualizador chamado SYMBOL. Qualquer SÍMBOLO tem um valor de texto associado ao padrão para um local em inglês ( "en") fornecidos com o visualizador pronto para uso e também podem ter valores definidos pelo usuário definidos para quantas localidades forem necessárias.

Quando o visualizador é iniciado, ele verifica o local atual para ver se há um valor definido pelo usuário para cada SYMBOL compatível para esse local. Se houver, ele usará o valor definido pelo usuário; caso contrário, ele voltará para o texto padrão pronto para uso.

Os dados de localização definidos pelo usuário podem ser passados para o visualizador como um objeto JSON de localização. Esse objeto contém a lista de localidades suportadas, valores de texto SYMBOL para cada localidade e a localidade padrão.

Um exemplo desse objeto de localização é o seguinte:

{
"en":{
"FlyoutZoomView.TIP_BUBBLE_OVER":"Mouse over to zoom",
"FlyoutZoomView.TIP_BUBBLE_TAP":"Tap and hold to zoom"
 },
 "fr":{
"FlyoutZoomView.TIP_BUBBLE_OVER":"Passez la souris sur pour zoomer",
"FlyoutZoomView.TIP_BUBBLE_TAP":"Appuyez et maintenez pour agrandir"
},
defaultLocale:"en"
}

No exemplo acima, o objeto de localização define dois locais ( "en" e "fr") e fornece localização para dois elementos da interface do usuário em cada local.

O código da página da Web deve passar esse objeto de localização para o construtor do visualizador, como um valor de localizedTexts do objeto de configuração. Uma opção alternativa é passar o objeto de localização chamando o setLocalizedTexts(localizationInfo) método.

Os seguintes SYMBOLs são suportados:

SÍMBOLO

Descrição

RÓTULO.Contêiner

Rótulo ARIA para o elemento do visualizador de nível superior.

FlyoutZoomView.ROLE_DESCRIPTION

Descrição da função ARIA para o componente de exibição principal.

FlyoutZoomView.USAGE_HINT

Dicas de uso ARIA para usuários de teclado.

FlyoutZoomView.TIP_BUBBLE_OVER

Mensagem de informação para sistemas desktop.

FlyoutZoomView.TIP_BUBBLE_TAP

Mensagem de informação para dispositivos sensíveis ao toque.

ScrollLeftButton.TOOLTIP

Dica de ferramenta do botão de rolagem para a esquerda.

ScrollRightButton.TOOLTIP

Dica de ferramenta do botão de rolagem para a direita.

BotãoDeRolagemParaCima.DICADEFERRAMENTA

Dica de ferramenta para o botão de rolagem para cima.

ScrollDownButton.TOOLTIP

Dica de ferramenta do botão de rolagem para baixo.

Nesta página