Documentação

O componente <t>

Envolva seu conteúdo no componente <t> e o conteúdo será traduzido. O conteúdo original é exibido até que sua tradução seja carregada.

<t>This content will be translated</t>

Texto com encadernações também funciona. O conteúdo é traduzido novamente sempre que muda, por exemplo, quando name muda:

<t>Hello {{ name() }}</t>

Todas as traduções solicitadas ao mesmo tempo são enviadas para a API em uma única solicitação, e as traduções são armazenadas em cache. Você pode usar quantos componentes <t> quiser.

<mt-translate> funciona como um seletor alternativo e Translate é o mesmo componente que T.

Entradas

EntradaTipoDescrição
formality'informal' | 'formal'Define a formalidade da tradução.
langLanguageSubstitui o idioma definido por provideMagicTranslate.
<t lang="fr" formality="formal">How are you?</t>

Limitações

Há muito poucas limitações:

  1. Você não pode colocar componentes Angular dentro do componente <t>. Elementos HTML simples são bons (veja o exemplo abaixo). A marcação traduzida passa pelo desinfetante HTML do Angular.
  2. O conteúdo dentro de um componente <t> não pode exceder 10 KB, o que equivale a cerca de 5.000 caracteres.
<!-- this is OK, since <a> is a plain HTML element -->
<t>
<a href="mailto:info@i42.ch">Please send us an email</a>
</t>
<!-- this does NOT work, since <app-button> is an Angular component -->
<t>
<app-button>Click me</app-button>
</t>

Para traduzir atributos e outras cadeias de caracteres, use o t pipe.