Документация: функция getLocalizedPath в intlayer

Описание

Функция getLocalizedPath преобразует канонический путь (внутренний путь приложения) в его локализованный эквивалент на основе указанной локали и правил перезаписи. Она особенно полезна для генерации SEO-дружественных URL, которые различаются по языку.

Ключевые возможности:

• Поддерживает динамические параметры маршрута, использующие синтаксис [param].
• Разрешает пути в соответствии с пользовательскими правилами перезаписи, определёнными в вашей конфигурации.
• Автоматически выполняет откат к каноническому пути, если для указанной локали не найдено правило перезаписи.

Сигнатура функции

getLocalizedPath(  canonicalPath: string,         // Обязательно  locale: Locales,               // Обязательно  rewriteRules?: RoutingConfig['rewrite'] // Необязательно): string

Параметры

Обязательные параметры

• canonicalPath: string

  • Описание: Внутренний путь приложения (например, /about, /product/[id]).
  • Тип: string
  • Обязательный: Да

• locale: Locales

  • Описание: Целевая локаль, для которой должен быть локализован путь.
  • Тип: Locales
  • Обязательный: Да

Необязательные параметры

• rewriteRules?: RoutingConfig['rewrite']
  • Описание: Объект, определяющий пользовательские правила перезаписи. Если не указан, по умолчанию используется свойство routing.rewrite из конфигурации проекта.
  • Тип: RoutingConfig['rewrite']
  • По умолчанию: configuration.routing.rewrite

Возвращаемое значение

• Тип: string
• Описание: Локализованный путь для указанной локали.

Пример использования

Базовое использование (с конфигурацией)

Если вы настроили пользовательские правила перезаписи в intlayer.config.ts:

import { getLocalizedPath, Locales } from "intlayer";// Configuration: { '/about': { en: '/about', fr: '/a-propos' } }getLocalizedPath("/about", Locales.FRENCH);// Output: "/a-propos"getLocalizedPath("/about", Locales.ENGLISH);// Output: "/about"

Использование с динамическими маршрутами

import { getLocalizedPath, Locales } from "intlayer";// Configuration: { '/product/[id]': { en: '/product/[id]', fr: '/produit/[id]' } }getLocalizedPath("/product/123", Locales.FRENCH);// Output: "/produit/123"

Ручные правила перезаписи

Вы также можете передать ручные правила перезаписи в функцию:

import { getLocalizedPath, Locales } from "intlayer";const manualRules = {  "/contact": {    en: "/contact-us",    fr: "/contactez-nous",  },};getLocalizedPath("/contact", Locales.FRENCH, manualRules);// Вывод: "/contactez-nous"

Связанные функции

• getCanonicalPath: Преобразует локализованный путь обратно во внутренний канонический путь.
• getLocalizedUrl: Генерирует полностью локализованный URL (включая протокол, хост и префикс локали).