Выведите первое переведённое сообщение

Покажите приветствие на испанском, подставьте имя и проверьте, как работает возврат к исходному тексту с локальным каталогом.

Выведите Hola, Ana. на основе исходного сообщения на английском. В примере уже есть испанский перевод, поэтому вы сможете увидеть, как компонент, каталог и провайдер работают вместе. Учётная запись Lingo.dev и ключ API не нужны.

Установите пакет в приложении на React 19 #

sh
npm install @lingo.dev/react@1.17.1

Для этого примера используйте существующее приложение на React 19. Хотя пакет указывает React 18 и 19 как peer-зависимости, его провайдер использует сокращённую запись провайдера контекста из React 19. Сама по себе установка пакета в проект на React 18 не подтверждает, что он сможет выводить в нём сообщения.

Добавьте приветствие и каталог #

Добавьте этот компонент в src/App.tsx и выведите его через существующую точку входа приложения:

tsx
import { computeKey, LingoProvider, useLingo } from "@lingo.dev/react";

const messages = {
  [computeKey("Hello, {name}.", "Greeting on the account dashboard")]:
    "Hola, {name}.",
};

function Greeting() {
  const l = useLingo();
  return (
    <h1>
      {l.text("Hello, {name}.", {
        context: "Greeting on the account dashboard",
        values: { name: "Ana" },
      })}
    </h1>
  );
}

export default function App() {
  return (
    <LingoProvider locale="es" messages={messages}>
      <Greeting />
    </LingoProvider>
  );
}

Запустите приложение командой для разработки и откройте страницу. В заголовке появится Hola, Ana. Среда выполнения вычислит тот же ключ по исходному тексту и контексту, найдёт испанский шаблон и заменит {name} на Ana.

Каталог содержит предложение целиком, поэтому перевод может менять порядок слов. Имя — это значение, а не часть ключа. Для другого имени используется та же запись каталога. Сохраните исходный текст и контекст в виде строковых литералов в вызове l.text, чтобы инструмент извлечения мог найти их позже.

Проверьте, что происходит без перевода #

Временно передайте провайдеру messages={{}}. Теперь в заголовке появится Hello, Ana. Исходный текст служит запасным шаблоном, а подстановка значений по-прежнему работает. Запись со значением "" тоже возвращает к исходному тексту.

Верните messages, затем измените только контекст вызова на "Greeting on the profile page". Контекст меняет идентификатор сообщения, поэтому прежний перевод больше не подходит. Верните исходный контекст, чтобы снова увидеть Hola, Ana. Эти проверки помогают отличить отсутствие каталога от несовпадения запрашиваемого и переведённого сообщений.

Замените локальный словарь извлечёнными каталогами #

Компонент готов к извлечению сообщений. В руководстве «Извлечение и загрузка каталогов» показано, как сгенерировать locales/en.jsonc, выбрать его в конфигурации CLI, получить перевод на испанский и безопасно загрузить его. Это следующая полноценная задача, а локальный пример выше по-прежнему пригодится для проверки вывода.

Если в приложении есть маршрутизация, перейдите к Next.js Pages или TanStack Start. При переключении локали нужно одновременно передавать новую локаль и её сообщения, чтобы интерфейс никогда не сочетал текст на одном языке с форматированием для другого.