Загрузка переводов

Проблема

Жёстко прописывать текст, например, 'Hello World', прямо в компонентах приложения — значит связывать контент с кодом. Чтобы показать другой язык, разработчикам приходится дублировать компонент или добавлять if/else-логику, что делает перевод неудобным для масштабирования и требует менять код при каждом новом тексте.

Решение

Используйте react-intl с IntlProvider для передачи переводов. Загружайте сообщения переводов на сервере в корневом layout, передавайте их в клиентский провайдер-компонент, а затем используйте их в других клиентских компонентах через хук useIntl.

Шаги

1. Установите react-intl

Сначала добавьте react-intl в зависимости вашего проекта.

npm install react-intl

2. Создайте плоские файлы переводов

Создайте папку dictionaries. Внутри добавьте JSON-файл для каждого языка. react-intl лучше всего работает с плоской структурой ключ-значение.

// dictionaries/en.json
{
  "home.title": "Home Page",
  "home.welcome": "Hello, welcome to our site!",
  "about.title": "About Us"
}

// dictionaries/es.json
{
  "home.title": "Página de Inicio",
  "home.welcome": "¡Hola, bienvenido a nuestro sitio!",
  "about.title": "Sobre Nosotros"
}

3. Создайте функцию для загрузки словарей

Создайте вспомогательную функцию, чтобы на сервере загружать нужный файл словаря в зависимости от параметра lang.

// app/get-dictionary.ts
import 'server-only';

// Define the type for our flat message object
type Messages = Record<string, string>;

const dictionaries: { [key: string]: () => Promise<Messages> } = {
  en: () => import('@/dictionaries/en.json').then((module) => module.default),
  es: () => import('@/dictionaries/es.json').then((module) => module.default),
  // fr: () => import('@/dictionaries/fr.json').then((module) => module.default),
};

export const getDictionary = async (lang: string) => {
  const load = dictionaries[lang];
  if (load) {
    return load();
  }
  // Fallback to English
  return dictionaries.en();
};

4. Создайте клиентский провайдер

IntlProvider — это клиентский компонент, использующий React Context. Нужно создать для него обёртку, которая сможет принимать сообщения, загруженные с сервера.

// app/components/IntlClientProvider.tsx
'use client';

import { IntlProvider } from 'react-intl';

type Props = {
  children: React.ReactNode;
  locale: string;
  messages: Record<string, string>; // Flat messages object
};

export default function IntlClientProvider({
  children,
  locale,
  messages,
}: Props) {
  return (
    <IntlProvider messages={messages} locale={locale} defaultLocale="en">
      {children}
    </IntlProvider>
  );
}

5. Обновите корневой layout

Измените app/[lang]/layout.tsx, чтобы он был async компонентом. Он будет загружать сообщения и передавать их в IntlClientProvider.

// app/[lang]/layout.tsx
import { getDictionary } from '@/app/get-dictionary';
import IntlClientProvider from '@/app/components/IntlClientProvider';

export async function generateStaticParams() {
  return [{ lang: 'en' }, { lang: 'es' }];
}

export default async function RootLayout({
  children,
  params,
}: {
  children: React.ReactNode;
  params: { lang: string };
}) {
  // Load messages on the server
  const messages = await getDictionary(params.lang);

  return (
    <html lang={params.lang}>
      <body>
        {/* Pass messages to the client provider */}
        <IntlClientProvider locale={params.lang} messages={messages}>
          {children}
        </IntlClientProvider>
      </body>
    </html>
  );
}

6. Используйте переводы в клиентском компоненте

Теперь вы можете использовать хук useIntl в любом клиентском компоненте. Серверные компоненты не могут использовать этот хук.

Создайте новый клиентский компонент для отображения переведённого текста:

// app/components/HomePageContent.tsx
'use client';

import { useIntl } from 'react-intl';

export default function HomePageContent() {
  const intl = useIntl();

  return (
    <div>
      <h1>{intl.formatMessage({ id: 'home.title' })}</h1>
      <p>{intl.formatMessage({ id: 'home.welcome' })}</p>
    </div>
  );
}

7. Добавьте компонент на свою страницу

В конце добавьте новый клиентский компонент на свою страницу.

// app/[lang]/page.tsx
import HomePageContent from '@/app/components/HomePageContent';

export default function Home() {
  // This page is a Server Component
  return (
    <div>
      {/* It renders the Client Component */}
      <HomePageContent />
    </div>
  );
}