Автор:

Надішліть цей документ вашому улюбленому AI-асистентуChatGPT Claude DeepSeek Google AI mode Gemini Perplexity Mistral Grok

Задайте питання та отримайте підсумок документа, вказавши цю сторінку та обраного вами постачальника штучного інтелекту

Історія версій

"Додано документацію для хуків useIntlayer, useDictionary, useLocale, middleware та форматерів"
v9.5.519.09.2026
"Уніфікована документація для всіх експортів"
v8.0.021.01.2026

Вміст цієї сторінки перекладено за допомогою штучного інтелекту.

Переглянути останню версію оригінального вмісту англійською

Редагувати цей документ

Якщо у вас є ідея щодо покращення цієї документації, будь ласка, долучіться, надіславши pull request на GitHub.

Посилання на документацію на GitHub

Дата створення:2026-01-21Останнє оновлення:2026-09-19

Копіювати

Скопіювати документацію у форматі Markdown в буфер обміну

Пакет astro-intlayer

Пакет astro-intlayer надає необхідні інструменти для інтеграції Intlayer у додатки Astro. Він налаштовує маршрутизацію на основі локалей, керування словниками, переписування сторінок під час збирання, middleware запитів та хуки для доступу до багатомовного контенту як у компонентах .astro, що рендеряться на сервері, так і в клієнтських скриптах.

Встановлення

bash

Копіювати код

Скопіюйте код у буфер обміну

npm install astro-intlayer

Експорти

Інтеграція

Пакет astro-intlayer надає інтеграцію Astro, яка налаштовує Intlayer у вашому проекті.

Імпорт:

tsx

Копіювати код

Скопіюйте код у буфер обміну

import { intlayer } from "astro-intlayer";

або імпорт за замовчуванням у astro.config.mjs:

Копіювати код

Скопіюйте код у буфер обміну

import { defineConfig } from "astro/config";
import intlayer from "astro-intlayer";

export default defineConfig({
  integrations: [intlayer()],
});

Показати весь вміст таблиці

Відкрийте таблицю в модальному вікні, щоб чітко переглянути всі дані

Функція	Опис	Пов'язана документація
`intlayer`	Інтеграція Astro, яка готує словники, налаштовує плагіни Vite (псевдоніми, проксі маршрутизації, оптимізацію збирання), автоматично реєструє middleware та створює пререндерені сторінки за локалізованими URL.	intlayer

Хуки (Сервер та Клієнт)

Імпорт:

tsx

Копіювати код

Скопіюйте код у буфер обміну

import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";

Показати весь вміст таблиці

Відкрийте таблицю в модальному вікні, щоб чітко переглянути всі дані

Хук	Опис	Пов'язана документація
`useIntlayer`	Отримує словник за ключем і повертає локалізований контент. У frontmatter `.astro` зчитує локаль запиту з `Astro.locals`. У клієнтському `<script>` зчитує зі сховища клієнта.	useIntlayer
`useDictionary`	Перетворює об'єкт словника та повертає вміст для визначеної локалі. Працює як у frontmatter, так і в клієнтських скриптах.	useDictionary
`useLocale`	Повертає поточну локаль, локаль за замовчуванням, доступні локалі та функцію для оновлення локалі.	useLocale

Middleware (astro-intlayer/middleware)

Імпорт:

tsx

Копіювати код

Скопіюйте код у буфер обміну

import { onRequest } from "astro-intlayer/middleware";

Показати весь вміст таблиці

Відкрийте таблицю в модальному вікні, щоб чітко переглянути всі дані

Експорт	Тип	Опис	Пов'язана документація
`onRequest`	`MiddlewareHandler`	Middleware Astro, яке визначає локаль запиту та додає `Astro.locals.intlayer`. Реєструється автоматично через `intlayer()` або імпортується для композиції.	onRequest

Утиліти

Імпорт:

tsx

Копіювати код

Скопіюйте код у буфер обміну

import { getIntlayerLocals } from "astro-intlayer";

Показати весь вміст таблиці

Відкрийте таблицю в модальному вікні, щоб чітко переглянути всі дані

Функція	Опис	Пов'язана документація
`getIntlayerLocals`	Допоміжна функція для отримання поточного об'єкта `IntlayerLocals` з контексту запиту поза межами Astro.locals.	-

Клієнтські утиліти (astro-intlayer/client)

Імпорт:

tsx

Копіювати код

Скопіюйте код у буфер обміну

import {
  useIntlayer,
  useDictionary,
  useDictionaryDynamic,
  useLocale,
  useLocaleStorage,
  useLocaleCookie,
  getIntlayer,
  getDictionary,
  installIntlayer,
  setLocaleInStorage,
  setLocaleCookie,
  localeInStorage,
  localeCookie,
} from "astro-intlayer/client";

При імпорті в браузері або всередині тегів <script> клієнта, astro-intlayer автоматично перенаправляється на astro-intlayer/client (на базі vanilla-intlayer), надаючи клієнтські гетери словників, підписки на сховище та інструменти збереження локалі.

Форматери (astro-intlayer/format)

Імпорт:

tsx

Копіювати код

Скопіюйте код у буфер обміну

import {
  useIntl,
  useDate,
  useNumber,
  useCurrency,
  usePercentage,
  useRelativeTime,
  useList,
  useUnit,
  useCompact,
} from "astro-intlayer/format";

Показати весь вміст таблиці

Відкрийте таблицю в модальному вікні, щоб чітко переглянути всі дані

Хук	Опис
`useIntl`	Повертає екземпляр Intl, прив'язаний до локалі запиту або клієнта, з можливістю кешування та підписки.
`useDate`	Повертає функцію форматування дати, прив'язану до поточної локалі (`Intl.DateTimeFormat`).
`useNumber`	Повертає функцію форматування чисел, прив'язану до поточної локалі (`Intl.NumberFormat`).
`useCurrency`	Повертає функцію форматування валюти, прив'язану до поточної локалі.
`usePercentage`	Повертає функцію форматування відсотків, прив'язану до поточної локалі.
`useRelativeTime`	Повертає функцію форматування відносного часу, прив'язану до поточної локалі (`Intl.RelativeTimeFormat`).
`useList`	Повертає функцію форматування списків, прив'язану до поточної локалі (`Intl.ListFormat`).
`useUnit`	Повертає функцію форматування одиниць вимірювання, прив'язану до поточної локалі.
`useCompact`	Повертає функцію компактного форматування чисел, прив'язану до поточної локалі (наприклад, `1.5K`).

Утиліти HTML (astro-intlayer/html)

Імпорт:

tsx

Копіювати код

Скопіюйте код у буфер обміну

import { renderHTML, useHTML, useHTMLRenderer } from "astro-intlayer/html";

Показати весь вміст таблиці

Відкрийте таблицю в модальному вікні, щоб чітко переглянути всі дані

Експорт	Тип	Опис
`renderHTML`	`Function`	Автономна утиліта для рендерингу вузлів HTML.
`useHTML`	`Hook`	Хук для отримання контексту постачальника HTML та конфігурації.
`useHTMLRenderer`	`Hook`	Хук для отримання попередньо налаштованої функції рендерингу HTML.

Утиліти Markdown (astro-intlayer/markdown)

Імпорт:

tsx

Копіювати код

Скопіюйте код у буфер обміну

import {
  compileMarkdown,
  renderMarkdown,
  parseMarkdown,
  useMarkdown,
  useMarkdownRenderer,
} from "astro-intlayer/markdown";

Показати весь вміст таблиці

Відкрийте таблицю в модальному вікні, щоб чітко переглянути всі дані

Експорт	Тип	Опис
`compileMarkdown`	`Function`	Компілює рядки markdown у структуроване представлення.
`renderMarkdown`	`Function`	Рендерить вміст markdown у вихідні вузли.
`parseMarkdown`	`Function`	Аналізує необроблений вміст markdown у дерево AST.
`useMarkdown`	`Hook`	Хук для отримання контексту постачальника markdown.
`useMarkdownRenderer`	`Hook`	Хук для отримання попередньо налаштованої функції рендерингу Markdown.

Типи

Імпорт:

tsx

Копіювати код

Скопіюйте код у буфер обміну

import type {
  IntlayerLocals,
  UseLocaleProps,
  UseLocaleResult,
} from "astro-intlayer";

Показати весь вміст таблиці

Відкрийте таблицю в модальному вікні, щоб чітко переглянути всі дані

Тип	Опис
`IntlayerLocals`	Об'єкт, прикріплений до `Astro.locals.intlayer`, що містить `locale`, `defaultLocale` та `availableLocales`.
`UseLocaleProps`	Необов'язкові властивості конфігурації, які приймає `useLocale()`.
`UseLocaleResult`	Тип повернення `useLocale()`, що надає властивості локалі та методи її оновлення.

lynx-intlayer intlayer