DictionaryTranslationOptions
Справочник API по типу DictionaryTranslationOptions
Обзор
Тип DictionaryTranslationOptions используется для передачи переменных в словарные записи и настройки их отображения.
Он применяется с useTranslations и getTranslations для передачи переменных в словарные записи.
Перевод на этапе сборки:
Переменные не переводятся с помощью useTranslations и getTranslations — переводится только исходная строка.
См. tx для перевода строк с динамическим содержимым.
Справочные материалы
Параметры
Prop
Type
Описание
| Свойство | Описание |
|---|---|
variables | Объект, в котором ключи указывают, куда подставляется каждое значение в записи словаря. |
Примеры
Передача переменных
Чтобы передать переменную в запись словаря, нужно сделать две вещи: (1) добавить переменную в запись и (2) сослаться на неё при вызове d.
Сначала добавим переменную в запись словаря со следующим синтаксисом: {username}.
username — это имя переменной.
const dictionary = {
greeting: {
hello: 'Привет, {username}!',
},
};
export default dictionary;Далее обратимся к переменной:
import { useTranslations } from 'gt-next';
const Component = () => {
const d = useTranslations();
return <div>{d('greeting.hello', { username : 'Brian123' })}</div>;
};Использование формата сообщений ICU
gt-next поддерживает формат сообщений ICU, который также позволяет форматировать переменные.
const dictionary = {
account: {
balance: 'Баланс вашего счёта: {dollars, number, ::currency/USD}!',
},
};
export default dictionary;Далее обратимся к переменной:
import { useTranslations } from 'gt-next';
const Component = () => {
const d = useTranslations();
return <div>
{ d(
'account.balance',
{
"dollars" : 1000000,
}
) }
</div>;
};Примечания
- Объект
variablesпередаёт значения в запись словаря. - Объект
variablesOptionsопределяет поведение переменных.
Следующие шаги
- См. словари для получения дополнительной информации о словарях и распространённых практиках.
- См.
useTranslationsилиgetTranslationsдля получения дополнительной информации об интерфейсе словарей. - См. формат сообщений ICU для получения дополнительной информации о вариантах форматирования.
Насколько полезно это руководство?