﻿---
description: Компонент, позволяющий переопределить локаль.
tags: provider
---

# LocaleProvider \[tag:component]

Компонент, позволяющий переопределить локаль.

## Локаль

Задаётся свойством `value`. В качестве значений принимает строку с [языковой меткой BCP 47](https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry).

```jsx
<LocaleProvider value="en">
  {/* часть вашего приложения, требующая переопределения локали */}
</LocaleProvider>
```

## Хук useLocale \[#use-locale]

Для получения значения текущей локали используйте хук `useLocale`:

```jsx
import { useLocale } from '@vkontakte/vkui';
```

```jsx
const locale = useLocale();
```

## Свойства и методы \[#api]

### LocaleProvider

| Свойство          | Тип         | По умолчанию | Описание                         |
| ----------------- | ----------- | ------------ | -------------------------------- |
| `**children** \*` | `ReactNode` | `-`          | Содержимое.                      |
| `**value** \*`    | `string`    | `-`          | Строка с языковой меткой BCP 47. |

### useLocale

*Не принимает свойств*
