openpencil/packages/docs/ru/programmable/sdk/api/advanced/locale-apis.md

40 lines
1.4 KiB
Markdown
Raw Normal View History

---
title: Locale APIs
description: Низкоуровневые хранилища локалей и метаданные, экспортируемые @open-pencil/vue.
---
# Locale APIs
В дополнение к `useI18n()`, Vue SDK экспортирует низкоуровневые примитивы локали для продвинутых интеграций:
- `locale`
- `localeSetting`
- `setLocale()`
- `AVAILABLE_LOCALES`
- `LOCALE_LABELS`
Используйте их, когда нужен прямой доступ к хранилищу, интеграция состояния локали с более крупной оболочкой приложения или метаданные локали без подписки на полный объект возврата `useI18n()`.
## Использование
```ts
import {
locale,
localeSetting,
setLocale,
AVAILABLE_LOCALES,
LOCALE_LABELS,
} from '@open-pencil/vue'
```
## Примечания
- `locale` — хранилище разрешённой активной локали
- `localeSetting` — хранилище сохранённых настроек пользователя
- `setLocale()` — обновляет настройки и активную локаль одновременно
- `AVAILABLE_LOCALES` и `LOCALE_LABELS` полезны для кастомных пикеров
## Связанные API
- [useI18n](../composables/use-i18n)