i18n
Regras
- Next.js App Router: usar
next-intl — hook useTranslations(), NextIntlClientProvider, middleware para detecção de localidade
- React SPA: usar
react-i18next — hook useTranslation(), i18n.init() com i18next-http-backend para carregamento sob demanda
- Roteamento com localidade:
/en/about, /fr/about — usar middleware para detectar o cabeçalho Accept-Language e redirecionar
- Arquivos de tradução: JSON por localidade por namespace —
messages/en/common.json, messages/fr/common.json
- Divisão por namespace: um namespace por funcionalidade/página —
auth.json, dashboard.json, settings.json — carregar apenas o que a página precisa
- Pluralização: usar formato de mensagem ICU —
{count, plural, one {# item} other {# items}}
- Interpolação:
t('greeting', { name }) — nunca concatenar strings traduzidas
- Data/número/moeda: usar
Intl.DateTimeFormat, Intl.NumberFormat — nunca codificar formatos
- Suporte RTL: usar
dir="rtl" no <html>, propriedades CSS lógicas (margin-inline-start em vez de margin-left), testar com árabe/hebraico
Padrões
import createMiddleware from "next-intl/middleware";
export default createMiddleware({
locales: ["en", "fr", "de", "ar"],
defaultLocale: "en",
});
import { useTranslations } from "next-intl";
function ProductCard({ price, date }: { price: number; date: Date }) {
const t = useTranslations("products");
const format = useFormatter();
return (
<div>
<h2>{t("title")}</h2>
<p>{format.number(price, { style: "currency", currency: "USD" })}</p>
<p>{format.dateTime(date, { dateStyle: "medium" })}</p>
</div>
);
}
Evitar
- Strings visíveis ao usuário codificadas — toda string deve passar por
t()
- Concatenação de strings para texto traduzido — usar interpolação ou formato ICU
- Carregar todas as localidades de uma vez — carregar sob demanda por localidade e namespace
- CSS
left/right para layout — usar propriedades lógicas para compatibilidade RTL
- Armazenar localidade apenas no localStorage — usar localidade baseada em URL para SEO e compartilhamento