# General Translation React SDKs (gt-react, gt-next, gt-react-native): useSetRegion
URL: https://generaltranslation.com/ja/docs/react/reference/hooks/use-set-region.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: アクティブなリージョンを変更します。useSetRegion の API リファレンス。

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

*`gt-react` と `gt-react-native` で利用できます。*

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

## 概要 [#overview]

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

*例では `gt-react` からインポートしていますが、代わりにお使いのフレームワークのパッケージからインポートしてください。*

```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) を使用してください。

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.