Posez votre question et obtenez un résumé du document en referencant cette page et le Provider AI de votre choix
En intégrant le serveur MCP Intlayer à votre assistant AI, vous pouvez récupérer tous les documents directement depuis ChatGPT, DeepSeek, Cursor, VSCode, etc.
Voir la documentation du serveur MCPLe contenu de cette page a été traduit à l'aide d'une IA.
Voir la dernière version du contenu original en anglaisSi vous avez une idée d’amélioration pour améliorer cette documentation, n’hésitez pas à contribuer en submitant une pull request sur GitHub.
Lien GitHub de la documentationCopier le Markdown du doc dans le presse-papiers
Documentation : Fonction getMultilingualUrls dans intlayer
Description
La fonction getMultilingualUrls génère une correspondance d'URLs multilingues en préfixant l'URL donnée avec chaque locale prise en charge. Elle peut gérer à la fois des URLs absolues et relatives, en appliquant le préfixe de locale approprié basé sur la configuration fournie ou les valeurs par défaut.
Paramètres
url: string
- Description : La chaîne URL originale à préfixer avec les locales.
- Type : string
locales: Locales[]
- Description : Tableau optionnel des locales supportées. Par défaut, les locales configurées dans le projet.
- Type : Locales[]
- Défaut : localesDefault
defaultLocale: Locales
- Description : La locale par défaut pour l'application. Par défaut, la locale par défaut configurée dans le projet.
- Type : Locales
- Défaut : defaultLocaleDefault
prefixDefault: boolean
- Description : Indique s'il faut préfixer la locale par défaut. Par défaut, la valeur configurée dans le projet.
- Type : boolean
- Défaut : prefixDefaultDefault
Retour
- Type : IConfigLocales<string>
- Description : Un objet associant chaque locale à son URL multilingue correspondante.
Exemple d'utilisation
URLs relatives
Copier le code dans le presse-papiers
import { getMultilingualUrls, Locales } from "intlayer";getMultilingualUrls( "/dashboard", [Locales.ENGLISH, Locales.FRENCH], Locales.ENGLISH, false);// Résultat : {// en: "/dashboard",// fr: "/fr/dashboard"// }
URLs absolues
Copier le code dans le presse-papiers
getMultilingualUrls( "https://example.com/dashboard", [Locales.ENGLISH, Locales.FRENCH], Locales.ENGLISH, true);// Résultat : {// en: "https://example.com/en/dashboard",// fr: "https://example.com/fr/dashboard"// }
Cas particuliers
Pas de segment de locale :
- La fonction supprime tout segment de langue existant dans l'URL avant de générer les correspondances multilingues.
Langue par défaut :
- Lorsque prefixDefault est false, la fonction ne préfixe pas l'URL pour la langue par défaut.
Langues non prises en charge :
- Seules les langues fournies dans le tableau locales sont prises en compte pour générer les URLs.
Utilisation dans les applications
Dans une application multilingue, configurer les paramètres d'internationalisation avec locales et defaultLocale est essentiel pour garantir l'affichage de la langue correcte. Voici un exemple de la façon dont getMultilingualUrls peut être utilisé dans la configuration d'une application :
Copier le code dans le presse-papiers
import { Locales, type IntlayerConfig } from "intlayer";// Configuration des langues supportées et de la langue par défautexport default { internationalization: { locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH], defaultLocale: Locales.ENGLISH, },} satisfies IntlayerConfig;export default config;
La configuration ci-dessus garantit que l'application reconnaît ENGLISH, FRENCH et SPANISH comme langues prises en charge et utilise ENGLISH comme langue de secours.
En utilisant cette configuration, la fonction getMultilingualUrls peut générer dynamiquement des correspondances d'URL multilingues basées sur les locales prises en charge par l'application :
Copier le code dans le presse-papiers
getMultilingualUrls( "/dashboard", [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH], Locales.ENGLISH);// Résultat :// {// en: "/dashboard",// fr: "/fr/dashboard",// es: "/es/dashboard"// }getMultilingualUrls( "https://example.com/dashboard", [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH], Locales.ENGLISH, true);// Résultat :// {// en: "https://example.com/en/dashboard",// fr: "https://example.com/fr/dashboard",// es: "https://example.com/es/dashboard"// }
En intégrant getMultilingualUrls, les développeurs peuvent maintenir des structures d'URL cohérentes à travers plusieurs langues, améliorant ainsi l'expérience utilisateur et le référencement SEO.
Historique de la documentation
- 5.5.10 - 2025-06-29 : Historique initial