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

title: useSetRegion
description: Изменяет активный регион с помощью General Translation gt-react. Справочник API по useSetRegion.

---

Хук `useSetRegion` возвращает функцию для изменения активного региона. Доступен только на стороне клиента.

*Доступно в `gt-react` и `gt-react-native`. В примерах показан импорт из `gt-react`; вместо этого импортируйте из пакета вашего фреймворка.*

*Примечание: не экспортируется из `gt-next` или `gt-tanstack-start`.*

## Обзор [#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]

При вызове возвращённая функция сохраняет выбранный регион в cookie-файле и перезагружает страницу, чтобы применить форматирование для этого региона. Передача `undefined` сбрасывает регион.

## Возвращаемое значение [#returns]

**Тип** `(region: string | undefined) => void`

Функция, которая устанавливает активный регион по указанному коду или сбрасывает его, если передать `undefined`.

## Заметки [#notes]

* `useSetRegion` доступен только на стороне клиента.
* Чтобы узнать активный регион, используйте [`useRegion`](/docs/react/reference/hooks/use-region). Если нужен готовый переключатель, используйте [`<RegionSelector>`](/docs/react/reference/components/region-selector).