Internacionalização (i18n)
Prioridade: P2 (MÉDIA)
Mantenha uma fonte única de verdade para os locales e garanta um roteamento de subcaminho amigável para SEO.
Diretrizes de Implementação
- Roteamento de Locale: Siga a abordagem URL-first para SEO. Use segmentos dinâmicos no App Router (ex.:
app/[lang]/page.tsx) e a configuraçãoi18nemnext.config.jspara o Pages Router. - Seleção de Biblioteca: Use
next-intlpara o App Router (moderno) oureact-intl/next-translatepara aplicações legadas. - Detecção: Implemente localização via Middleware (em
middleware.ts) para detectar o idioma do usuário a partir dos cabeçalhosAccept-Languageou cookies e realizar redirecionamentos. - Lado do Servidor: Carregue dicionários de tradução
messages/*.jsonem Componentes Servidor para manter o bundle do cliente pequeno. Use os padrõesgetMessages()ourequestConfig. - SEO: Garanta que as tags
hreflangsejam geradas corretamente na APImetadatapara todas as rotas traduzidas. - Geração Estática: Use
generateStaticParamspara pré-renderizar versões localizadas de páginas estáticas no momento da build.module.exports = { i18n: { locales: ['en', 'fr', 'vi'], defaultLocale: 'en', }, };
3. Especificidades da Biblioteca
Para configurações detalhadas com bibliotecas comuns, consulte:
Anti-Padrões
- Sem strings fixas em JSX: Use chaves de tradução; nunca insira texto bruto.
- Sem bundles de tradução no cliente: Carregue dicionários no servidor com
getMessages(). - Sem padrões de URL de locale misturados: Use subcaminhos ou domínios de forma consistente.