Types

DictionaryTranslationOptions

Справочник по API для типа DictionaryTranslationOptions

Обзор

Тип DictionaryTranslationOptions используется для передачи переменных в словарные записи и задания способов их отображения. Он применяется вместе с useTranslations для передачи переменных в словарные записи.

Перевод на этапе сборки: Переводы с useTranslations выполняются на этапе сборки; при этом сами переменные не переводятся. Вместо этого они подставляются в перевод с нужным форматированием. Обязательно следуйте руководству по развёртыванию.

Справочник

Параметры

Prop

Type

Описание

PropОписание
variablesОбъект, в котором ключи указывают, к каким полям записи словаря сопоставляются соответствующие значения.

Примеры

Передача переменных

Чтобы передать переменную в запись словаря, нужно сделать две вещи: (1) добавить переменную в запись и (2) сослаться на неё при вызове d.

Сначала добавим переменную в запись словаря со следующим синтаксисом: {username}. username — это имя переменной.

dictionary.ts
const dictionary = {
  greeting: {
    hello: 'Привет, {username}!',
  },
};

export default dictionary;

Далее обратимся к переменной:

Component.tsx
import { useTranslations } from 'gt-react';

const Component = () => {
  const d = useTranslations();
  return <div>{d('greeting.hello', { username : 'Brian123' })}</div>;
};

Использование формата сообщений ICU

gt-react поддерживает формат сообщений ICU, что позволяет форматировать и переменные.

dictionary.ts
const dictionary = {
  account: {
    balance: 'Баланс вашего аккаунта: {dollars, number, ::currency/USD}!',
  },
};

export default dictionary;

Далее мы ссылаемся на переменную:

Component.tsx
import { useTranslations } from 'gt-react';

const Component = () => {
  const d = useTranslations();
  return <div>
    { d(
      'account.balance',
      {
        "dollars": 1000000
      }
    ) }
  </div>;
};

Примечания

  • Объект variables передаёт значения в элемент словаря.
  • Объект variablesOptions определяет поведение переменных.

Дальнейшие шаги

  • См. dictionaries для получения дополнительной информации о словарях и распространённых практиках.
  • См. useTranslations для получения дополнительной информации об интерфейсе словарей.
  • См. ICU message format для получения дополнительной информации о вариантах форматирования.

Насколько полезно это руководство?

DictionaryTranslationOptions