Preact एकीकरण: usePathname हुक दस्तावेज़ीकरण

usePathname हुक ब्राउज़र के वर्तमान पाथनेम (pathname) को locale सेगमेंट हटाकर लौटाता है। यह locale-aware नेविगेशन बनाने के लिए उपयोगी है — उदाहरण के लिए, यह निर्धारित करना कि कौन सा नेव आइटम सक्रिय (active) है — बिना locale उपसर्ग (prefix) को मैन्युअली हटाए।

Preact में usePathname आयात करना

import { usePathname } from "preact-intlayer";

अवलोकन (Overview)

usePathname window.location.pathname को पढ़ता है, getPathWithoutLocale के माध्यम से locale उपसर्ग (prefix) को हटाता है, और जब भी ब्राउज़र popstate घटना (बैक/फॉरवर्ड नेविगेशन) को ट्रिगर करता है, तो यह घटक (component) को फिर से रेंडर करता है। सर्वर-साइड रेंडरिंग (SSR) के दौरान यह एक खाली स्ट्रिंग लौटाता है।

उपयोग (Usage)

import type { FunctionComponent } from "preact";import { usePathname } from "preact-intlayer";type NavItemProps = {  href: string;  label: string;};const NavItem: FunctionComponent<NavItemProps> = ({ href, label }) => {  const pathname = usePathname();  const isActive = pathname === href;  return (    <a href={href} aria-current={isActive ? "page" : undefined}>      {label}    </a>  );};export default NavItem;

रिटर्न वैल्यू (Return Value)

व्यवहार (Behavior)

• Locale को हटाना (Locale stripping): URL के शुरुआत में मौजूद locale सेगमेंट को हटाता है (उदा. /hi/dashboard → /dashboard)।
• रिएक्टिव (Reactive): popstate घटनाओं (ब्राउज़र बैक / फॉरवर्ड नेविगेशन) पर स्वचालित रूप से अपडेट होता है।
• SSR-सुरक्षित (SSR-safe): जब window उपलब्ध नहीं होता है तो "" लौटाता है।
• क्लीनअप (Cleanup): जब कंपोनेंट अनमाउंट होता है, तो popstate श्रोता (listener) स्वचालित रूप से हटा दिया जाता है।

उदाहरण (Example)

import type { FunctionComponent } from "preact";import { usePathname } from "preact-intlayer";const links = [  { href: "/dashboard", label: "डैशबोर्ड" },  { href: "/settings", label: "सेटिंग्स" },];const Sidebar: FunctionComponent = () => {  const pathname = usePathname();  return (    <nav>      {links.map(({ href, label }) => (        <a          key={href}          href={href}          style={{ fontWeight: pathname === href ? "bold" : "normal" }}        >          {label}        </a>      ))}    </nav>  );};export default Sidebar;

संबंधित (Related)

• useLocale — वर्तमान locale + locale स्विचर
• getPathWithoutLocale — इस हुक द्वारा उपयोग की जाने वाली मुख्य उपयोगिता (utility)