Локализация метаданных страницы

Проблема

Пользователь просматривает страницу на испанском, и весь видимый контент переведён правильно. Однако вкладка браузера и сниппет в поисковой выдаче всё ещё отображают английские title и description. Такое несоответствие метаданных сбивает с толку и ухудшает SEO, показывая нерелевантную информацию в поиске.

Решение

Используйте функцию Next.js generateMetadata в своих страницах и layout'ах. Эта серверная функция может загружать нужные переводы на основе параметра lang (используя ту же логику загрузки словаря, что и в компонентах) и возвращать динамический объект metadata с локализованными title и description.

Шаги

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

Вам нужен способ загружать ваши плоские файлы переводов на сервере. Для этого создайте вспомогательную функцию.

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

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),
};

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

2. Определите метаданные на странице

В файле вашей страницы (например, app/[lang]/about/page.tsx) экспортируйте функцию async с именем generateMetadata. Next.js автоматически вызовет её при рендере страницы.

// app/[lang]/about/page.tsx
import { getDictionary } from '@/app/get-dictionary';
import type { Metadata } from 'next';

type Props = {
  params: { lang: string };
};

// This function generates metadata
export async function generateMetadata({ params }: Props): Promise<Metadata> {
  // Load the dictionary for this page
  const dict = await getDictionary(params.lang);

  return {
    title: dict['about.title'], // e.g., "About Us" or "Sobre Nosotros"
    description: dict['about.description'],
  };
}

// The rest of your page component
export default function AboutPage() {
  return (
    <div>
      {/* Page content */}
      <h1>...</h1>
    </div>
  );
}

3. Задайте шаблон title в корневом layout

Чтобы не повторять название сайта в каждом title, можно задать шаблон в корневом layout.

// app/[lang]/layout.tsx
import { getDictionary } from '@/app/get-dictionary';
import type { Metadata } from 'next';

type Props = {
  params: { lang: string };
  children: React.ReactNode;
};

// You can generate metadata in layouts too
export async function generateMetadata({ params }: Props): Promise<Metadata> {
  const dict = await getDictionary(params.lang);

  return {
    // This provides a base title and a template
    title: {
      default: dict['site.name'], // e.g., "My Awesome Site"
      template: `%s | ${dict['site.name']}`, // e.g., "About Us | My Awesome Site"
    },
    description: dict['site.description'],
  };
}

export default async function RootLayout({ children, params }: Props) {
  // ... rest of your layout (loading providers, etc.)
  return (
    <html lang={params.lang}>
      <body>{children}</body>
    </html>
  );
}