Автор:
    Создание:2026-06-22Последнее обновление:2026-06-22

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

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

    Импорт usePathname во Vue

    typescript
    import { usePathname } from "vue-intlayer";

    Обзор

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

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

    src/components/NavItem.vue
    <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>

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

    Тип Описание
    ComputedRef<string> Вычисляемое свойство (computed ref) Vue, содержащее текущий путь (pathname) без префикса локали.

    Поведение

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

    Пример

    src/components/Sidebar.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 — базовая утилита, используемая этим хуком