InlineTranslationOptions
Справочник API по типу InlineTranslationOptions
Обзор
Тип InlineTranslationOptions используется для передачи переменных во встроенные переводы и задания их поведения при рендеринге.
Вы также можете добавить к переводу контекст и идентификатор.
Он используется с useGT и msg для передачи переменных во встроенные строковые переводы.
Перевод на этапе сборки:
Переводы useGT и msg выполняются на этапе сборки; при этом переменные никогда не переводятся.
Вместо этого они вставляются в перевод с нужным форматированием.
Обязательно следуйте руководству по деплою.
Справочник
Параметры
Prop
Type
Описание
| Prop | Описание |
|---|---|
variables | Объект, в котором ключи указывают, куда подставляется каждое значение в строке. |
$context | При необходимости добавьте $context как переменную в объект variables, чтобы передать контекст для содержимого (используется при переводе). |
$id | При необходимости добавьте $id как переменную в объект variables, чтобы указать идентификатор для использования в редакторе перевода. |
Примеры
Контекст
Чтобы добавить контекст к строке, используйте проп $context.
import { useGT } from 'gt-react';
const Component = () => {
const t = useGT();
return <div>{t('Здравствуйте, мир!', { $context: 'официальное приветствие' })}</div>;
};Передача переменных
Чтобы добавить переменную в строку, используйте синтаксис {variable-name}, где имя переменной заключено в фигурные скобки.
import { useGT } from 'gt-react';
const Component = () => {
const t = useGT();
return <div>{t('Привет, {username}! Как твой день?', { username: 'Brian123' })}</div>;
};Использование формата сообщений ICU
gt-react поддерживает формат сообщений ICU, который также позволяет форматировать переменные.
import { useGT } from 'gt-react';
const Component = () => {
const t = useGT();
return <div>
{ t(
'На вашем счёте: {dollars, number, ::currency/USD}!',
{
"dollars" : 1000000,
}
) }
</div>;
};См. документацию по формату сообщений ICU, чтобы узнать больше о формате сообщений ICU.
Заметки
InlineTranslationOptionsиспользуется для перевода встроенных строк.- Объект
variablesподставляет значения в текст. - Объект
variablesOptionsзадаёт поведение переменных.
Следующие шаги
- См.
useGTдля получения дополнительных сведений о переводах встроенных строк. - См.
формат сообщений ICUдля получения дополнительных сведений о вариантах форматирования.
Насколько полезно это руководство?