7. Internacionalización
7.1. Ejemplo 21: una aplicación bilingüe
Una aplicación bilingüe tiene tres tipos de texto que traducir:
- el texto de la aplicación: etiquetas y mensajes. Se almacenan en diccionarios, uno por idioma;
- las fechas y los importes: el objeto [Intl] de [JavaScript] los formatea en el idioma deseado (véase el Ejemplo 09);
- el texto de [Ionic] mismo: los meses y días de su calendario, sus botones. El calendario ([<ion-datetime>]) recibe el idioma mediante su atributo [locale].
7.1.1. Los diccionarios
Cada texto tiene una clave ("HOME.HELLO"). Los parámetros se escriben como [{{name}}]; un texto con plural tiene varias claves: [_zero], [_one], [_other]. Estas son las convenciones de la biblioteca [JavaScript] [i18next] , utilizada por los clientes [React] y [Vue.js] de [RdvMedecins]: el caso de estudio usará sus diccionarios, complementados con algunas claves adicionales. El diccionario en inglés tiene las mismas claves:
Los archivos de la carpeta [public/] del proyecto se entregan tal cual con la aplicación (en un navegador: en la dirección /i18n/ex21-fr.json; en [Android]: dentro de la propia aplicación). En comparación con los diccionarios del ejemplo de [Flutter], se han agregado dos claves: [CALENDAR_OK] y [CALENDAR_CANCEL], que corresponden a los botones del calendario (se tratan más adelante).
7.1.2. Traducciones
- línea 25: los idiomas de la aplicación;
- línea 28: el tipo de un diccionario: un objeto en el que cada propiedad es un texto u otro diccionario (el tipo es recursivo: se referencia a sí mismo);
- líneas 30–33: las traducciones almacenan el idioma actual y su diccionario en variables. Una clase simple, no un servicio [@Injectable]: cada usuario la crea con su propio prefijo (línea 36; el Ejemplo 25 tendrá sus diccionarios, [ex25-fr.json]...). Se proporcionará a la página mediante una “fábrica” (se trata más adelante);
- línea 36: [private readonly prefix] en los parámetros del constructor declara E inicializa un campo: un atajo de [TypeScript];
- líneas 40–44: el idioma de origen: el almacenado en el dispositivo (el plugin [@capacitor/preferences] del Ejemplo 20); de lo contrario, el idioma del teléfono ([navigator.language]: “en-US”, de la cual se conservan las dos primeras letras), si se conoce; de lo contrario, inglés;
- líneas 46–54: cambiar de idioma: leer el diccionario mediante [fetch], la función de [JavaScript] que lee una dirección (en este caso, un archivo incluido con la aplicación) y devuelve una [Promise] que representa la respuesta; decodificar su contenido JSON ([response.json()], otra [Promise]); almacenar el diccionario y el idioma en sus respectivos campos; actualizar el idioma de la página (el atributo [lang] de la etiqueta [<html>], útil para los lectores de pantalla); guardar la selección en el dispositivo. Habríamos podido usar el cliente HTTP de [Angular] (Ejemplo 22): [fetch] evita depender de él en una clase simple;
- líneas 57–63: búsqueda de una clave “HOME.HELLO” en el diccionario: se desciende parte por parte ([split('.')]) a través de los objetos JSON anidados. [typeof node === 'object'] es una comprobación de tipo que “estrecha” el tipo de la variable en la rama donde es verdadera: [TypeScript] sabe entonces que [node] es un diccionario. Leer la signal ([this._dictionary()], línea 58) es esencial: una plantilla que llama a [t()] lee la signal de este modo y se actualizará cuando cambie el diccionario;
- líneas 65–79: la traducción. Para un plural (un parámetro numérico [count]), [Intl.PluralRules] devuelve la forma plural según las reglas del idioma: [select(n)] da como resultado [one] u [other] (otros idiomas tienen también [two], [few], [many]). En francés, 0 y 1 son singular ([one]); en inglés, solo 1. La clave [_zero], si existe, tiene prioridad sobre 0 (línea 72), igual que con [i18next]. Una clave desconocida se muestra tal cual (línea 76): se ve de inmediato qué falta. Por último (línea 78), cada [{{name}}] se reemplaza por el valor del parámetro: una expresión regular, [/\{\{(\w+)\}\}/g], y una función que recibe cada coincidencia ([all]) y el nombre capturado entre paréntesis ([name]).
¿Por qué no usar la herramienta oficial de [Angular]? [Angular] tiene su propio sistema de internacionalización ([@angular/localize]): se marcan los textos de las plantillas ([<p i18n>Hello</p>]), se extraen las traducciones a archivos y la compilación produce UNA aplicación por cada idioma. Es la mejor solución para un sitio web en el que todo el texto se conoce de antemano. Sin embargo, no cambia de idioma “sobre la marcha”, y nuestro servidor devuelve claves (“ERRORS.LOGIN_TAKEN”) que deben traducirse en tiempo de ejecución: un diccionario, consultado por la clave, es mucho más adecuado para este fin y permite compartir diccionarios con otros clientes. También existen bibliotecas que hacen esto para [Angular] ([ngx-translate], [Transloco]): nuestro servicio es una versión mínima de ellas.
7.1.3. La página traducida
- líneas 25–28 (.ts): lo que el servidor devolvería para [RdvMedecins]: un código HTTP, una clave y sus parámetros;
- línea 38 (.ts): un proveedor ESPECÍFICO de la página: [providers] en el decorador [@Component] crea una instancia de las traducciones para esta página (y sus componentes), que se destruye junto con ella. [useFactory] proporciona la función que la crea, junto con su prefijo;
- líneas 40–42 (.ts): el tamaño de la selección de idioma y el de la ventana del calendario (un cuadro de diálogo dimensionado según su contenido, en lugar de una página completa);
- línea 47 (.ts): las traducciones, obtenidas como un servicio;
- líneas 54–59 (.ts): la fecha y el precio, formateados en el idioma actual por [Intl.DateTimeFormat] ([dateStyle: 'full']: “Tuesday, October 6, 2026”, “mardi 6 octobre 2026”) e [Intl.NumberFormat] ([style: 'currency']: “€1,234.50”, “1 234,50 €”). Son signals calculadas: detectan el idioma y se recalculan cuando este cambia. (Los pipes [date] y [currency] de [Angular] también aceptan un idioma como parámetro, pero en ese caso hay que registrar las reglas de cada idioma, como lo hace [main.ts] para el francés.)
- línea 61 (.ts): el idioma del calendario, en el formato idioma-país que espera [<ion-datetime>];
- línea 65 (.ts): el idioma de origen;
- líneas 68–69 (.ts): el título del documento (la pestaña del navegador), traducido: el servicio [Title] de [Angular], invocado por un efecto, que se vuelve a ejecutar cuando cambia el idioma;
- líneas 74–76 (.ts): selección del idioma;
- línea 10 (html): el título de la página, traducido;
- líneas 12–16 (html): la selección de idioma en la barra superior: un [<ion-segment>], formado por botones, de los cuales solo uno está seleccionado ([value]), el equivalente del [SegmentedButton] de [Flutter];
- líneas 23–25 (HTML): texto con parámetros. La fecha y el precio, ya formateados, se pasan como parámetros;
- línea 27 (html): [count] selecciona la forma plural y reemplaza [{{count}}];
- líneas 34–47 (html): el calendario, en una ventana modal ([<ion-modal>]) que abre el botón cuyo [id] se especifica en su atributo [trigger]. Su contenido, en un [<ng-template>], se crea solo cuando se abre la ventana. [<ion-datetime>] formatea los meses y días mediante [Intl], en el idioma especificado por su atributo [[locale]]; [[firstDayOfWeek]]: la semana comienza el lunes en francés y el domingo en inglés. Sus botones (“Done”, “Cancel” de forma predeterminada) no son traducidos por [locale]: [[doneText]] y [[cancelText]] reciben los textos de nuestros diccionarios. Esto era el paquete [flutter_localizations] junto con [Flutter];
- líneas 58–61 (html): lo que devolvería el servidor [RdvMedecins]. La clave del servidor ES una clave del diccionario; sus parámetros son los del texto.
7.1.4. El resultado
En inglés (izquierda); en francés, después de una adición (centro); el calendario, en francés (derecha):
![]() | ![]() | ![]() |
Cambiar el idioma vuelve a traducir toda la pantalla sin reiniciar ni hacer ninguna solicitud al servidor: el idioma y el diccionario son signals, y todo lo que las lee (texto de la plantilla, fecha, precio, título) las sigue. El idioma seleccionado se almacena en el dispositivo: vuelva a iniciar la aplicación (en el navegador, recargue la página) y se abrirá en el último idioma seleccionado.


