# gt-next: General Translation Next.js SDK: DictionaryTranslationOptions
URL: https://generaltranslation.com/ja/docs/next/api/types/dictionary-translation-options.mdx
---
title: DictionaryTranslationOptions
description: DictionaryTranslationOptions 型の API リファレンス
---

## 概要

`DictionaryTranslationOptions` 型は、辞書エントリに変数を渡し、レンダリング動作を指定するために使用します。
[`useTranslations`](/docs/next/api/dictionary/use-translations) および [`getTranslations`](/docs/next/api/dictionary/get-translations) と組み合わせて使い、辞書エントリに変数を渡します。

<Callout>
  **ビルド時翻訳:**
  [`useTranslations`](/docs/next/api/dictionary/use-translations) および [`getTranslations`](/docs/next/api/dictionary/get-translations) では、翻訳されるのは元の文字列のみで、変数は翻訳されません。
  動的な内容を含む文字列を翻訳する場合は、[`tx`](/docs/next/api/strings/tx) を参照してください。
</Callout>

## リファレンス

### パラメータ

<TypeTable
  type={{
  "[variable]?": {
      type: 'any',
      optional: true,
      default: 'undefined',
  },
}}
/>

### 説明

| プロパティ        | 説明                                                                                     |
| ------------ | -------------------------------------------------------------------------------------- |
| `[variable]` | 変数は `options` オブジェクトのトップレベルのキーとして渡されます。キー名は、辞書エントリ内のプレースホルダー (例: `{username}`) に対応します。 |

***

## 例

### 変数を渡す

辞書エントリに変数を渡すには、次の 2 つが必要です。(1) エントリに変数を追加すること、(2) [`d`](/docs/next/api/strings/use-gt) の呼び出しでその変数を参照することです。

まず、次の構文で辞書エントリに変数を追加します: `{username}`。
`username` は変数名です。

```jsx title="dictionary.ts"
// [!code word:username]
const dictionary = {
  greeting: {
    hello: 'Hello, {username}!',
  },
};

export default dictionary;
```

次に、変数を参照します。

```jsx title="Component.tsx"
// [!code word:username]
import { useTranslations } from 'gt-next';

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


### ICUメッセージ形式を使用する

`gt-next` は ICU メッセージ形式をサポートしており、変数の書式も指定できます。

```jsx title="dictionary.ts"
// [!code word:account-balance]
const dictionary = {
  account: {
    balance: 'Your account balance: {dollars, number, ::currency/USD}!',
  },
};

export default dictionary;
```

次に、変数を参照します。

```jsx title="Component.tsx"
// [!code word:account-balance]
import { useTranslations } from 'gt-next';

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

***


## 注意事項

* 変数は `variables` キーの下にネストせず、options オブジェクトのトップレベルのキーとして渡します。

### 次のステップ

* 辞書と一般的な使い方について詳しくは、[dictionaries](/docs/next/guides/dictionaries)を参照してください。
* 辞書インターフェースについて詳しくは、[`useTranslations`](/docs/next/api/dictionary/use-translations)または[`getTranslations`](/docs/next/api/dictionary/get-translations)を参照してください。
* フォーマットオプションについて詳しくは、[`ICUメッセージ形式`](https://unicode-org.github.io/icu/userguide/format_parse/messages/)を参照してください。