# General Translation React SDKs (gt-react, gt-next): useSetRegion
URL: https://generaltranslation.com/ja/docs/react/reference/hooks/use-set-region.mdx
---

title: useSetRegion
description: General Translation の gt-react でアクティブなリージョンを変更します。useSetRegion の API リファレンス。

---

`useSetRegion` hook は、アクティブなリージョンを変更する関数を返します。クライアントサイドでのみ使用できます。

*`gt-react` と `gt-react-native` で利用できます。例では `gt-react` から import していますが、代わりにお使いのフレームワークのパッケージから import してください。*

*注: `gt-next` または `gt-tanstack-start` からは export されていません。*

## 概要 [#overview]

`useSetRegion` を呼び出して設定関数を取得し、次にリージョンコードを渡して呼び出します。

```tsx
import { useSetRegion } from 'gt-react';

export default function RegionButton() {
  const setRegion = useSetRegion();
  return <button onClick={() => setRegion('CA')}>Switch to Canada</button>;
}
```

*注: `useSetRegion` はクライアントサイド専用で、[`<GTProvider>`](/docs/react/reference/components/gt-provider) の配下で使用する必要があります。*

## 仕組み [#how-it-works]

返された関数を呼び出すと、選択したリージョンがクッキーに保存され、リージョン固有の書式が適用されるようにページが再読み込みされます。`undefined` を渡すと、リージョンはクリアされます。

## 戻り値 [#returns]

**型** `(region: string | undefined) => void`

アクティブなリージョンを指定したコードに設定し、`undefined` が渡された場合はクリアする関数です。

## メモ [#notes]

* `useSetRegion` はクライアントサイドでのみ利用できます。
* アクティブなリージョンを確認するには [`useRegion`](/docs/react/reference/hooks/use-region) を使用してください。すぐに使える切り替え UI が必要な場合は [`<RegionSelector>`](/docs/react/reference/components/region-selector) を使用してください。