Интеграция с Vue: Документация usePathname

Функция usePathname возвращает текущий путь (pathname) браузера с удалённым сегментом локали в виде вычисляемого свойства (computed ref) Vue, ComputedRef<string>. Это полезно для создания навигации с учётом локали — например, для определения активного элемента меню — без необходимости вручную удалять префикс локали.

Импорт usePathname во Vue

import { usePathname } from "vue-intlayer";

Обзор

usePathname создаёт вычисляемое свойство Vue (computed ref), которое считывает window.location.pathname, удаляет префикс локали с помощью getPathWithoutLocale и обновляет своё значение каждый раз, когда браузер вызывает событие popstate (навигация назад/вперёд). Полученное значение можно использовать непосредственно в шаблонах (templates) Vue или в функции setup.

Использование

<script setup lang="ts">
import { usePathname } from "vue-intlayer";

const props = defineProps<{
  href: string;
  label: string;
}>();

const pathname = usePathname();
</script>

<template>
  <a :href="href" :aria-current="pathname === href ? 'page' : undefined">
    {{ label }}
  </a>
</template>

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

Поведение

• Удаление локали: Удаляет начальный сегмент локали (например, /ru/dashboard → /dashboard).
• Реактивность: Обновляет значение при каждом событии popstate (при навигации назад/вперёд в браузере).
• Безопасность для SSR: Возвращает "", если объект window недоступен.
• Очистка (Cleanup): Слушатель события popstate добавляется глобально при инициализации и обычно не требует ручной очистки в каждом компоненте благодаря механизмам жизненного цикла Vue.

Пример

<script setup lang="ts">
import { usePathname } from "vue-intlayer";

const links = [
  { href: "/dashboard", label: "Дашборд" },
  { href: "/settings", label: "Настройки" },
];

const pathname = usePathname();
</script>

<template>
  <nav>
    <a
      v-for="link in links"
      :key="link.href"
      :href="link.href"
      :style="{ fontWeight: pathname === link.href ? 'bold' : 'normal' }"
    >
      {{ link.label }}
    </a>
  </nav>
</template>

Связанные разделы

• useLocale — текущая локаль + переключатель локали
• getPathWithoutLocale — базовая утилита, используемая этим хуком