Types

DictionaryTranslationOptions

Справочник API по типу DictionaryTranslationOptions

Обзор

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

Перевод на этапе сборки: Переменные не переводятся с помощью useTranslations и getTranslations — переводится только исходная строка. См. tx для перевода строк с динамическим содержимым.

Справочные материалы

Параметры

Prop

Type

Описание

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

Примеры

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

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

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

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

export default dictionary;

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

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

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

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

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

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

export default dictionary;

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

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

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

Примечания

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

Следующие шаги

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

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

DictionaryTranslationOptions