# gt-react: General Translation React SDK: useLocaleProperties
URL: https://generaltranslation.com/ru/docs/react/api/helpers/use-locale-properties.mdx
---
title: useLocaleProperties
description: Справочник по API для хука useLocaleProperties
---

{/* СГЕНЕРИРОВАНО АВТОМАТИЧЕСКИ: Не редактируйте напрямую. Вместо этого отредактируйте template в content/docs-templates/. */}


## Обзор

Хук `useLocaleProperties` возвращает метаданные об указанной локали, включая её название, нативное название, язык, регион и сведения о системе письма.

<Callout>
  `useLocaleProperties` — это клиентский хук, и *его можно использовать только в клиентских компонентах*.
  Убедитесь, что ваше приложение обёрнуто в [`<GTProvider>`](/docs/react/api/components/gtprovider).
</Callout>

## Справочник

### Параметры

| Параметр | Тип      | Описание                                                   |
| -------- | -------- | ---------------------------------------------------------- |
| `locale` | `string` | Код локали в формате BCP 47 (например, `'en-US'`, `'ja'`). |

### Возвращает

Объект `LocaleProperties` со следующими полями:

| Поле                       | Тип      | Описание                                                          |
| -------------------------- | -------- | ----------------------------------------------------------------- |
| `code`                     | `string` | Код локали (например, `'en-US'`).                                 |
| `name`                     | `string` | Английское название локали (например, `'American English'`).      |
| `nativeName`               | `string` | Нативное название локали на её собственном языке.                 |
| `languageCode`             | `string` | Подтег языка (например, `'en'`).                                  |
| `languageName`             | `string` | Английское название языка.                                        |
| `nativeLanguageName`       | `string` | Название языка на его собственном языке.                          |
| `nameWithRegionCode`       | `string` | Название локали с указанием региона (например, `'English (US)'`). |
| `nativeNameWithRegionCode` | `string` | Нативное название локали на её собственном языке с указанием региона. |
| `regionCode`               | `string` | Подтег региона (например, `'US'`).                                |
| `regionName`               | `string` | Английское название региона.                                      |
| `nativeRegionName`         | `string` | Название региона на языке локали.                                 |
| `scriptCode`               | `string` | Подтег системы письма (например, `'Latn'`).                       |
| `scriptName`               | `string` | Английское название системы письма.                               |
| `nativeScriptName`         | `string` | Название системы письма на языке локали.                          |
| `maximizedCode`            | `string` | Полностью развернутый код локали (например, `'en-Latn-US'`).      |

***

## Примеры

### Основы использования

```jsx title="LocaleInfo.jsx" copy
'use client';
import { useLocaleProperties } from 'gt-react';
import { useLocale } from 'gt-react';

export default function LocaleInfo() {
  const locale = useLocale();
  const props = useLocaleProperties(locale); // [!code highlight]
  return (
    <div>
      <p>Name: {props.name}</p>
      <p>Native name: {props.nativeName}</p>
      <p>Region: {props.regionName}</p>
    </div>
  );
}
```

***


## Примечания

* Этот хук синхронный — он сразу возвращает свойства.
* Полезно для создания пользовательских селекторов локали и отображения метаданных локали для пользователей.

## Следующие шаги

* Подробнее о [кодах локалей](/docs/core/locales).