Determinado conteúdo que o Visualizador de Flyout exibe está sujeito à localização. Esse conteúdo inclui dicas de ferramentas de elementos da interface do usuário e mensagens de informações exibidas pela visualização de zoom de flyout durante o carregamento.
Todo conteúdo textual no visualizador que pode ser localizado é representado pelo identificador especial do SDK do visualizador chamado SYMBOL. Qualquer SYMBOL tem um valor de texto associado padrão para uma localidade em inglês ( "en"
) fornecido com o visualizador pronto para uso, e também pode 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, retorna ao 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 compatíveis, valores de texto SYMBOL para cada localidade e o local 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 duas localidades ( "en"
e "fr"
) e fornece a localização de dois elementos da interface do usuário em cada localidade.
O código da página da Web deve passar esse objeto de localização para o construtor do visualizador, como um valor da variável localizedTexts
do objeto de configuração. Uma opção alternativa é passar o objeto de localização chamando a função setLocalizedTexts(localizationInfo)
método .
Os seguintes SYMBOLs são suportados:
SÍMBOLO |
Descrição |
---|---|
Container.LABEL |
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 de ARIA para usuários de teclado. |
FlyoutZoomView.TIP_BUBBLE_OVER |
Mensagem de informações para sistemas de desktop. |
FlyoutZoomView.TIP_BUBBLE_TAP |
Mensagem de informação para dispositivos de toque. |
ScrollLeftButton.TOOLTIP |
Dica de ferramenta para o botão de rolagem à esquerda. |
ScrollRightButton.TOOLTIP |
Dica de ferramenta para o botão de rolagem para a direita. |
ScrollUpButton.TOOLTIP |
Dica de ferramenta para o botão de rolagem para cima. |
ScrollDownButton.TOOLTIP |
Dica de ferramenta para o botão de rolagem para baixo. |