Dokumentation: getLocalizedPath-Funktion in intlayer

Beschreibung

Die Funktion getLocalizedPath wandelt einen kanonischen Pfad (interner Anwendungs-Pfad) in sein lokalisiertes Äquivalent um, basierend auf der angegebenen Locale und den Rewrite-Regeln. Sie ist besonders nützlich, um SEO-freundliche URLs zu erzeugen, die je nach Sprache variieren.

Wesentliche Merkmale:

• Unterstützt dynamische Routenparameter mithilfe der [param]-Syntax.
• Löst Pfade entsprechend benutzerdefinierten Rewrite-Regeln, die in deiner Konfiguration definiert sind.
• Handhabt automatisch einen Fallback auf den kanonischen Pfad, falls keine Rewrite-Regel für die angegebene Locale gefunden wird.

Funktionssignatur

getLocalizedPath(
  canonicalPath: string,         // Erforderlich
  locale: Locales,               // Erforderlich
  rewriteRules?: RoutingConfig['rewrite'] // Optional
): string

Parameter

Erforderliche Parameter

• canonicalPath: string

  • Beschreibung: Der interne Anwendungs-Pfad (z. B. /about, /product/[id]).
  • Typ: string
  • Erforderlich: Ja

• locale: Locales

  • Beschreibung: Die Ziel-Locale, für die der Pfad lokalisiert werden soll.
  • Typ: Locales
  • Erforderlich: Ja

Optionale Parameter

• rewriteRules?: RoutingConfig['rewrite']
  • Beschreibung: Ein Objekt, das benutzerdefinierte Rewrite-Regeln definiert. Wenn nicht angegeben, wird standardmäßig die Eigenschaft routing.rewrite aus der Konfiguration Ihres Projekts verwendet.
  • Typ: RoutingConfig['rewrite']
  • Standard: configuration.routing.rewrite

Rückgabewert

• Typ: string
• Beschreibung: Der lokalisierte Pfad für die angegebene Locale.

Beispielverwendung

Grundlegende Verwendung (mit Konfiguration)

Wenn Sie benutzerdefinierte Rewrite-Regeln in Ihrer intlayer.config.ts konfiguriert haben:

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"

Verwendung mit dynamischen Routen

import { getLocalizedPath, Locales } from "intlayer";

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

Manuelle Rewrite-Regeln

Sie können der Funktion auch manuelle Rewrite-Regeln übergeben:

import { getLocalizedPath, Locales } from "intlayer";

const manualRules = {
  "/contact": {
    en: "/contact-us",
    fr: "/contactez-nous",
  },
};

getLocalizedPath("/contact", Locales.FRENCH, manualRules);
// Ausgabe: "/contactez-nous"

Verwandte Funktionen

• getCanonicalPath: Löst einen lokalisierten Pfad zurück auf seinen internen kanonischen Pfad.
• getLocalizedUrl: Erzeugt eine vollständig lokalisierte URL (inkl. Protokoll, Host und Locale-Präfix).