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 de emails para mensagens disparadas pela interação (por exemplo, emails de código de verificação). Veja Localização de templates de email.
  • Expõe o valor original para os templates de email como uma variável uiLocales, permitindo que você o inclua no assunto / conteúdo do email, se necessário.

Formato do parâmetro​

  • Nome: ui_locales
  • Tipo: string
  • Valor: Lista separada por espaço 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 emails 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, recai para fr, depois en.
  • ui_locales=ja mas japonês não está habilitado → Recorre ao Accept-Language ou ao padrão do tenant.