7. Internacionalização
7.1. Exemplo 21: Uma aplicação bilíngue
Uma aplicação bilíngue tem três tipos de texto a traduzir:
- os textos da aplicação: rótulos e mensagens. Eles são armazenados em dicionários, um por idioma;
- datas e valores: o objeto [Intl] do [JavaScript] os formata no idioma desejado (veja o Exemplo 09);
- os textos do próprio [Ionic] : os meses e dias do calendário, seus botões. O calendário ([<ion-datetime>]) recebe o idioma por meio do atributo [locale].
7.1.1. Os dicionários
Cada texto tem uma chave ("HOME.HELLO"). Os parâmetros são escritos como [{{name}}]; um texto no plural tem várias chaves: [_zero], [_one], [_other]. Essas são as convenções da biblioteca [JavaScript] [i18next] , usada pelos clientes [React] e [Vue.js] do [RdvMedecins]: o estudo de caso usará os dicionários deles, complementados com algumas chaves adicionais. O dicionário em inglês tem as mesmas chaves:
Os arquivos da pasta [public/] do projeto são entregues como estão com a aplicação (em um navegador: no endereço /i18n/ex21-fr.json; no [Android]: dentro da própria aplicação). Em comparação com os dicionários do exemplo do [Flutter], duas chaves foram adicionadas: [CALENDAR_OK] e [CALENDAR_CANCEL], que correspondem aos botões do calendário (discutidos adiante).
7.1.2. Traduções
- linha 25: os idiomas da aplicação;
- linha 28: o tipo de um dicionário—um objeto em que cada propriedade é um texto ou outro dicionário (o tipo é recursivo: ele faz referência a si mesmo);
- linhas 30–33: a classe de traduções armazena o idioma atual e seu dicionário em variáveis. Uma classe simples, não um serviço [@Injectable]: cada usuário a cria com seu próprio prefixo (linha 36; o Exemplo 25 terá seus dicionários, [ex25-fr.json]...). Ela será fornecida à página por uma “factory” (discutida adiante);
- linha 36: [private readonly prefix] nos parâmetros do construtor declara E inicializa um campo: um atalho do [TypeScript];
- linhas 40–44: o idioma de origem: o armazenado no dispositivo (o plugin [@capacitor/preferences] do Exemplo 20); caso contrário, o idioma do celular ([navigator.language]: “en-US”, do qual são mantidas as duas primeiras letras), se conhecido; caso contrário, o inglês;
- linhas 46–54: mudar de idioma: ler o dicionário com [fetch], a função do [JavaScript] que lê um endereço (neste caso, um arquivo incluído na aplicação) e retorna uma [Promise] que representa a resposta; decodificar seu conteúdo JSON ([response.json()], outra [Promise]); armazenar o dicionário e o idioma em seus respectivos campos; atualizar o idioma da página (o atributo [lang] da tag [<html>], útil para leitores de tela); salvar a seleção no dispositivo. Poderíamos ter usado o cliente HTTP do [Angular] (Exemplo 22): [fetch] evita depender dele em uma classe simples;
- linhas 57–63: busca de uma chave “HOME.HELLO” no dicionário: descemos parte por parte ([split('.')]) pelos objetos JSON aninhados. [typeof node === 'object'] é uma verificação de tipo que “restringe” o tipo da variável no ramo em que é verdadeira: o [TypeScript] passa então a saber que [node] é um dicionário. A leitura do signal ([this._dictionary()], linha 58) é essencial: um template que chama [t()] lê o signal dessa forma e será atualizado quando o dicionário mudar;
- Linhas 65–79: a tradução. Para um plural (um parâmetro numérico [count]), [Intl.PluralRules] retorna a forma plural de acordo com as regras do idioma: [select(n)] resulta em [one] ou [other] (outros idiomas também têm [two], [few], [many]). Em francês, 0 e 1 são singulares ([one]); em inglês, apenas 1. A chave [_zero], se existir, tem precedência sobre 0 (linha 72), assim como no [i18next]. Uma chave desconhecida é exibida como está (linha 76): você vê imediatamente o que está faltando. Por fim (linha 78), cada [{{name}}] é substituído pelo valor do parâmetro: uma expressão regular, [/\{\{(\w+)\}\}/g], e uma função que recebe cada correspondência ([all]) e o nome capturado entre parênteses ([name]).
Por que não usar a ferramenta oficial do [Angular]? [Angular] tem seu próprio sistema de internacionalização ([@angular/localize]): marcamos os textos dos templates ([<p i18n>Hello</p>]), extraímos as traduções para arquivos, e a compilação produz UMA aplicação para cada idioma. Essa é a melhor solução para um site em que todos os textos são conhecidos de antemão. No entanto, ela não troca de idioma “em tempo real”, e nosso servidor retorna chaves (“ERRORS.LOGIN_TAKEN”) que precisam ser traduzidas em tempo de execução: um dicionário, consultado pela chave, é muito mais adequado para isso e nos permite compartilhar dicionários com outros clientes. Existem também bibliotecas que fazem isso para o [Angular] ([ngx-translate], [Transloco]): nosso serviço é uma versão mínima delas.
7.1.3. A página traduzida
- linhas 25–28 (.ts): o que o servidor retornaria para o [RdvMedecins]: um código HTTP, uma chave e seus parâmetros;
- linha 38 (.ts): um provider ESPECÍFICO da página: [providers] no decorador [@Component] cria uma instância das traduções para esta página (e seus componentes), que é destruída junto com ela. [useFactory] fornece a função que a cria, junto com seu prefixo;
- linhas 40–42 (.ts): o tamanho da seleção de idioma e o da janela do calendário (uma caixa de diálogo dimensionada de acordo com seu conteúdo, em vez de uma página inteira);
- linha 47 (.ts): as traduções, obtidas como um serviço;
- linhas 54–59 (.ts): a data e o preço, formatados no idioma atual por [Intl.DateTimeFormat] ([dateStyle: 'full']: “Tuesday, October 6, 2026”, “mardi 6 octobre 2026”) e [Intl.NumberFormat] ([style: 'currency']: “€1,234.50”, “1 234,50 €”). Eles são signals calculados: detectam o idioma e são recalculados quando ele muda. (Os pipes [date] e [currency] do [Angular] também aceitam um idioma como parâmetro, mas nesse caso é preciso registrar as regras de cada idioma, como o [main.ts] faz para o francês.)
- linha 61 (.ts): o idioma do calendário, no formato idioma-país esperado por [<ion-datetime>];
- linha 65 (.ts): o idioma de origem;
- linhas 68–69 (.ts): o título do documento (a aba do navegador), traduzido: o serviço [Title] do [Angular], chamado por um efeito, que é reexecutado quando o idioma muda;
- linhas 74–76 (.ts): seleção de idioma;
- linha 10 (html): o título da página, traduzido;
- linhas 12–16 (html): a seleção de idioma na barra superior: um [<ion-segment>], composto de botões, dos quais apenas um é selecionado ([value]), o equivalente ao [SegmentedButton] do [Flutter];
- linhas 23–25 (HTML): texto parametrizado. A data e o preço, já formatados, são passados como parâmetros;
- linha 27 (html): [count] seleciona a forma plural e substitui [{{count}}];
- Linhas 34–47 (html): o calendário, em uma janela modal ([<ion-modal>]) aberta pelo botão cujo [id] é especificado pelo seu atributo [trigger]. Seu conteúdo, em um [<ng-template>], é criado somente quando a janela é aberta. [<ion-datetime>] formata os meses e dias usando [Intl], no idioma especificado pelo seu atributo [[locale]]; [[firstDayOfWeek]]: a semana começa na segunda-feira em francês e no domingo em inglês. Seus botões (“Done”, “Cancel” por padrão) não são traduzidos por [locale]: [[doneText]] e [[cancelText]] recebem os textos dos nossos dicionários. Isso era feito pelo pacote [flutter_localizations] junto com o [Flutter];
- linhas 58–61 (html): o que o servidor [RdvMedecins] retornaria. A chave do servidor É uma chave do dicionário; seus parâmetros são os do texto.
7.1.4. A saída
Em inglês (à esquerda); em francês, após uma adição (no meio); o calendário, em francês (à direita):
![]() | ![]() | ![]() |
Mudar o idioma retraduz a tela inteira sem reiniciar nem fazer requisições ao servidor: o idioma e o dicionário são signals, e tudo que os lê (texto do template, data, preço, título) os acompanha. O idioma selecionado é armazenado no dispositivo: reinicie o aplicativo (no navegador, recarregue a página), e ele será aberto no último idioma selecionado.


