Pular para o conteúdo principal

Idiomas da interface (UI locales)

O Logto suporta o parâmetro padrão de autenticação OIDC ui_locales para controlar o idioma da experiência de login e das comunicações subsequentes para uma determinada interação.

O que faz​

  • Determina o idioma da interface da experiência de login hospedada pelo Logto em tempo de execução. O Logto seleciona a primeira tag de idioma em ui_locales que é suportada na biblioteca de idiomas do seu tenant.
  • Afeta a localização dos e-mails para mensagens disparadas pela interação (por exemplo, e-mails de código de verificação). Veja Localização de templates de e-mail.
  • Expõe o valor original para os templates de e-mail como uma variável uiLocales, permitindo incluí-lo no assunto/conteúdo do e-mail se necessário.
  • Define o código de país padrão do número de telefone na experiência de login. Por exemplo, se ui_locales=fr, o campo de entrada do número de telefone será padrão para França (+33). Isso é útil quando você deseja controlar o código de país padrão programaticamente para grupos de usuários ou regiões específicas.

Formato do parâmetro​

  • Nome: ui_locales
  • Tipo: string
  • Valor: Lista separada por espaços de tags de idioma BCP 47, por exemplo, fr-CA fr en.
  • Referência: OpenID Connect Core - ui_locales

Ordem de resolução e precedência​

Ao determinar o idioma da interface para a experiência de login e e-mails relacionados, o Logto resolve o idioma do usuário final nesta ordem:

  1. ui_locales da solicitação de autenticação atual (a primeira tag suportada vence).
  2. Caso contrário, cabeçalho Accept-Language (Experience APIs / User Account APIs) ou messagePayload.locale (Management APIs como convites de organização).
  3. Caso contrário, o idioma padrão do tenant configurado na Experiência de Login.

Esse comportamento não altera permanentemente suas configurações de idioma; aplica-se apenas à interação atual.

Uso em SDK​

Se você estiver usando um SDK do Logto, passe ui_locales via extraParams na chamada de login para que seja encaminhado para a solicitação de autorização:

await logtoClient.signIn({
  redirectUri: 'https://your.app/callback',
  extraParams: {
    ui_locales: 'fr-CA fr en',
  },
});

Exemplos​

  • ui_locales=fr-CA fr en → Se fr-CA existir na sua biblioteca de idiomas, a interface de login será exibida em francês (Canadá); caso contrário, será feito fallback para fr, depois en.
  • ui_locales=ja mas japonês não está habilitado → Fallback para Accept-Language ou idioma padrão do tenant.