TypeScript
Переводите литеральные значения в статических модулях локалей с экспортом по умолчанию, сохраняя синтаксис TypeScript вокруг них.
В модуле локали на TypeScript вы можете хранить сообщения рядом с типами, которые их описывают. Обработчик файлов typescript переводит литеральные значения в статическом экспорте по умолчанию. Он заменяет текст на месте, сохраняя ключи, импорты, комментарии и синтаксис типов вокруг него. При этом обработчик читает исходный код, не выполняя модуль.
Передайте обработчику статический каталог #
Задайте объект или массив прямо в экспорте по умолчанию:
export default {
checkout: {
title: "Complete your order",
retries: 3,
},
steps: ["Review", "Confirm"],
} as const;К строковым единицам перевода относятся checkout.title, steps[0] и steps[1]. Числовое значение остаётся без изменений. as const, satisfies и скобки вокруг поддерживаемых выражений можно оставить в исходном коде.
Задавайте переводимые значения литералами. Обработчик не ищет объявление экспортируемого идентификатора и не вычисляет результат вызова фабрики. Он пропускает вычисляемые ключи свойств, операции развёртывания, методы и значения, полученные из выражений. Шаблонные литералы поддерживаются только без подстановки выражений. Если модуль корректен, но задач для перевода нет, сначала проверьте структуру экспорта по умолчанию и лишь затем ищите сбой перевода.
Явно укажите, какие принятые значения сохранить #
Предыдущая версия исходного каталога помогает определить изменения по путям в каталоге. Из существующего целевого каталога берутся принятые значения для строк, которые не изменились или значения которых не удалось определить другим способом. Для заблокированных путей сохраняется текущий исходный литерал. Для путей с сохранением перевода — существующее целевое значение, если оно есть. Эти настройки не запускают код для поиска дополнительного текста.
При замене используются те же кавычки, что и в исходном литерале. Переведённый текст экранируется с учётом этих кавычек. При обновлении по ключам сохраняются целевые значения, не выбранные для обновления. Записи исходного каталога, которых нет в таком частичном результате, могут быть удалены, в том числе элементы массива. Поэтому перед загрузкой модуля проверьте итоговые ключи и состав массивов.
Настройте выбор файлов #
CLI автоматически определяет typescript для .ts, .mts и .cts, но не для .js или .tsx. Выберите модули локалей в разделе Конфигурация CLI или через GitHub.
Загрузите переведённый модуль #
Этот формат работает отдельно от извлечения сообщений React. При извлечении инструмент читает поддерживаемые вызовы в исходных файлах приложения .ts и .tsx и создаёт каталог. А этот обработчик переводит уже структурированный модуль локали. Подробнее об этом процессе — в разделе Каталоги и типы React.
После получения модуля проверьте его типы и загрузите через загрузчик каталогов приложения. Сопоставьте выбранные ключи с сообщениями, которые используются на экране, затем проверьте работу плейсхолдеров. Эти проверки выявляют разные проблемы: некорректный модуль не загрузится, невыбранное динамическое значение останется без перевода, а формально корректный перевод всё же может передавать неверный смысл.