Angular Integration: usePathname Hook Documentation

The usePathname hook returns the current browser pathname with the locale segment stripped, as an Angular Signal<string>. It is useful for building locale-aware navigation — for example, determining which nav item is active — without having to manually remove the locale prefix.

Importing usePathname in Angular

import { usePathname } from "angular-intlayer";

Overview

usePathname reads window.location.pathname, strips the locale prefix via getPathWithoutLocale, and updates the signal whenever the browser fires a popstate event (back/forward navigation). It uses Angular's DestroyRef to clean up the event listener automatically when the component is destroyed.

Usage

import { Component, input } from "@angular/core";import { usePathname } from "angular-intlayer";@Component({  standalone: true,  selector: "app-nav-item",  template: `    <a      [href]="href()"      [attr.aria-current]="pathname() === href() ? 'page' : null"    >      {{ label() }}    </a>  `,})export class NavItemComponent {  readonly href = input.required<string>();  readonly label = input.required<string>();  readonly pathname = usePathname();}

Return Value

Behavior

• Locale stripping: Removes the leading locale segment (e.g. /fr/dashboard → /dashboard).
• Reactive: Updates automatically on popstate events (browser back / forward navigation).
• SSR-safe: Returns "" when window is not available.
• Cleanup: The popstate listener is removed via DestroyRef.onDestroy when the host component is destroyed.

Example

import { Component } from "@angular/core";import { usePathname } from "angular-intlayer";@Component({  standalone: true,  selector: "app-sidebar",  template: `    <nav>      @for (link of links; track link.href) {        <a          [href]="link.href"          [style.font-weight]="pathname() === link.href ? 'bold' : 'normal'"        >          {{ link.label }}        </a>      }    </nav>  `,})export class SidebarComponent {  readonly links = [    { href: "/dashboard", label: "Dashboard" },    { href: "/settings", label: "Settings" },  ];  readonly pathname = usePathname();}

Related

• useLocale — current locale + locale switcher
• getPathWithoutLocale — the underlying utility used by this hook