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

title: useSetRegion
description: 使用 General Translation gt-react 更改活动区域。useSetRegion 的 API 参考。

---

`useSetRegion` 钩子会返回一个用于更改活动区域的函数。它仅限客户端使用。

*可用于 `gt-react` 和 `gt-react-native`。示例从 `gt-react` 导入；请改为从你所用框架对应的包中导入。*

*注意：`gt-next` 或 `gt-tanstack-start` 不会导出此项。*

## 概览 [#overview]

调用 `useSetRegion` 获取 setter 函数，然后传入区域代码进行调用。

```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]

调用返回的函数后，所选 区域 会保存到 cookie 中，并重新加载页面，以应用对应 区域 的格式。传入 `undefined` 会清除该 区域 设置。

## 返回值 [#returns]

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

一个函数，用于将活动区域设置为给定的代码；如果传入 `undefined`，则清除该设置。

## 注意事项 [#notes]

* `useSetRegion` 仅可在客户端使用。
* 要读取当前生效的区域，请使用 [`useRegion`](/docs/react/reference/hooks/use-region)。如果需要现成的切换组件，请使用 [`<RegionSelector>`](/docs/react/reference/components/region-selector)。