Haz tu pregunta y obtén un resumen del documento referenciando esta página y el proveedor AI de tu elección
Al integrar el servidor MCP Intlayer a tu asistente de IA, puedes recuperar todos los documentos directamente desde ChatGPT, DeepSeek, Cursor, VSCode, etc.
Ver la documentación del servidor MCPEl contenido de esta página ha sido traducido con una IA.
Ver la última versión del contenido original en inglésSi tienes una idea para mejorar esta documentación, no dudes en contribuir enviando una pull request en GitHub.
Enlace de GitHub a la documentaciónCopiar el Markdown del documento a la portapapeles
Documentación: Función getLocalizedUrl en intlayer
Descripción
La función getLocalizedUrl genera una URL localizada anteponiendo la URL dada con el locale especificado. Maneja tanto URLs absolutas como relativas, asegurando que se aplique el prefijo de locale correcto según la configuración.
Parámetros
url: string
- Descripción: La cadena de URL original a la que se le antepondrá un locale.
- Tipo: string
currentLocale: Locales
- Descripción: El locale actual para el cual se está localizando la URL.
- Tipo: Locales
locales: Locales[]
- Descripción: Array opcional de locales soportados. Por defecto, se proporcionan los locales configurados en el proyecto.
- Tipo: Locales[]
- Por defecto: Configuración del Proyecto
defaultLocale: Locales
- Descripción: El locale por defecto para la aplicación. Por defecto, se proporciona el locale por defecto configurado en el proyecto.
- Tipo: Locales
- Por defecto: Configuración del Proyecto
prefixDefault: boolean
- Descripción: Indica si se debe anteponer el prefijo para el locale por defecto. Por defecto, se proporciona el valor configurado en el proyecto.
- Tipo: boolean
- Por defecto: Configuración del Proyecto
Retorna
- Tipo: string
- Descripción: La URL localizada para el locale especificado.
Ejemplo de Uso
URLs Relativas
Copiar el código al portapapeles
import { getLocalizedUrl, Locales } from "intlayer";getLocalizedUrl( "/about", Locales.FRENCH, [Locales.ENGLISH, Locales.FRENCH], Locales.ENGLISH, false);// Salida: "/fr/about" para el locale francés// Salida: "/about" para el locale por defecto (inglés)
URLs Absolutas
Copiar el código al portapapeles
getLocalizedUrl( "https://example.com/about", Locales.FRENCH, // Locale Actual [Locales.ENGLISH, Locales.FRENCH], // Locales Soportados Locales.ENGLISH, // Locale por Defecto false // Prefijar el Locale por Defecto); // Salida: "https://example.com/fr/about" para el francésgetLocalizedUrl( "https://example.com/about", Locales.ENGLISH, // Locale Actual [Locales.ENGLISH, Locales.FRENCH], // Locales Soportados Locales.ENGLISH, // Locale por Defecto false // Prefijar el Locale por Defecto); // Salida: "https://example.com/about" para el inglésgetLocalizedUrl( "https://example.com/about", Locales.ENGLISH, // Locale Actual [Locales.ENGLISH, Locales.FRENCH], // Locales Soportados Locales.ENGLISH, // Locale por Defecto true // Prefijar el Locale por Defecto); // Salida: "https://example.com/en/about" para el inglés
Locale No Soportado
Copiar el código al portapapeles
getLocalizedUrl( "/about", Locales.ITALIAN, // Locale Actual [Locales.ENGLISH, Locales.FRENCH], // Locales Soportados Locales.ENGLISH // Locale por Defecto); // Salida: "/about" (no se aplica prefijo para locales no soportados)
Casos Especiales
Sin Segmento de Locale:
- Si la URL no contiene ningún segmento de locale, la función añade de forma segura el locale apropiado como prefijo.
Locale por Defecto:
- Cuando prefixDefault es false, la función no añade prefijo a la URL para el locale por defecto.
Locales No Soportados:
- Para locales que no están listados en locales, la función no aplica ningún prefijo.
Uso en Aplicaciones
En una aplicación multilingüe, configurar los ajustes de internacionalización con locales y defaultLocale es fundamental para asegurar que se muestre el idioma correcto. A continuación, se muestra un ejemplo de cómo getLocalizedUrl puede usarse en la configuración de una aplicación:
Copiar el código al portapapeles
import { Locales, type IntlayerConfig } from "intlayer";// Configuración para locales soportados y locale por defectoexport default { internationalization: { locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH], defaultLocale: Locales.ENGLISH, },} satisfies IntlayerConfig;export default config;
La configuración anterior asegura que la aplicación reconozca ENGLISH, FRENCH y SPANISH como idiomas soportados y utilice ENGLISH como idioma predeterminado.
Usando esta configuración, la función getLocalizedUrl puede generar dinámicamente URLs localizadas basadas en la preferencia de idioma del usuario:
Copiar el código al portapapeles
getLocalizedUrl("/about", Locales.FRENCH); // Salida: "/fr/about"getLocalizedUrl("/about", Locales.SPANISH); // Salida: "/es/about"getLocalizedUrl("/about", Locales.ENGLISH); // Salida: "/about"
Al integrar getLocalizedUrl, los desarrolladores pueden mantener estructuras de URL consistentes en múltiples idiomas, mejorando tanto la experiencia del usuario como el SEO.
Historial del Documento
- 5.5.10 - 2025-06-29: Historial inicial