Marking text for translation in Angular

Introduction

Marking text for translation helps your app show content in different languages. It tells Angular which parts to translate.

You want your app to support multiple languages for users worldwide.

You have static text in your templates that should change based on user language.

You want to prepare your app for future translations without changing code later.

Syntax

Angular

<p i18n>Text to translate</p>

Use the i18n attribute on HTML elements to mark text for translation.

You can add a description like i18n="meaning|description" to help translators.

Examples

This marks the heading text for translation.

Angular

<h1 i18n>Welcome to our site</h1>

Here, a description helps translators understand the button's purpose.

Angular

<button i18n="button label|Submit button">Submit</button>

You can mark text with nested HTML tags for translation.

Angular

<p i18n>Click <strong>here</strong> to continue.</p>

Sample Program

This simple Angular template marks text and buttons for translation so they can appear in different languages.

Angular

<!-- app.component.html -->
<h2 i18n>Choose your language</h2>
<button i18n="button label|English language button">English</button>
<button i18n="button label|Spanish language button">Español</button>

Important Notes

Mark only the text users see, not variable names or code.

Use clear descriptions in i18n attributes to help translators.

Angular extracts these marked texts into files for translators to work on.

Summary

Use the i18n attribute to mark text for translation in Angular templates.

Adding descriptions helps translators understand context.

This prepares your app to support multiple languages easily.

Practice

1. What is the primary purpose of the i18n attribute in Angular templates?

easy

A. To mark text for translation in the app

B. To style text with international fonts

C. To add animations to text elements

D. To bind data to the text content

Solution

1. Step 1: Understand the role of i18n in Angular

   The i18n attribute is used to mark text that should be translated for different languages.

2. Step 2: Differentiate from other attributes

   It is not related to styling, animations, or data binding, which are handled by other Angular features.

3. Final Answer:

   To mark text for translation in the app -> Option A

4. Quick Check:

   i18n attribute = mark text for translation [OK]

Hint: Remember: i18n means internationalization for translation [OK]

Common Mistakes:

• Confusing i18n with styling or animations
• Thinking i18n binds data instead of marking text
• Assuming i18n is a directive instead of an attribute

2. Which of the following is the correct syntax to mark a paragraph for translation with a description in Angular?

easy

A. Welcome to our site!

B. Welcome to our site!

C. @@desc

D. Welcome to our site!

Solution

1. Step 1: Recognize the correct i18n attribute format

   The i18n attribute can include a description or meaning using the syntax i18n="@@desc" to help translators.

2. Step 2: Check each option's syntax

   Welcome to our site!

   correctly uses i18n="@@desc" inside the paragraph tag. Options B, C, and D misuse the attribute or place description incorrectly.

3. Final Answer:

   <p i18n="@@desc">Welcome to our site!</p> -> Option D

4. Quick Check:

   Correct i18n syntax with description =

   Welcome to our site!

   [OK]

Hint: Use i18n="@@description" inside the tag for descriptions [OK]

Common Mistakes:

• Placing description outside the tag
• Using i18n-desc instead of i18n
• Confusing description with translation key

3. Given the template code:

<h1 i18n="@@titleDesc">Hello, user!</h1>

What will Angular do with this text during the build process?

medium

A. Throw a syntax error because of the @@ prefix

B. Display 'Hello, user!' without any translation

C. Extract 'Hello, user!' for translation with the description 'titleDesc'

D. Ignore the i18n attribute and render the text as is

Solution

1. Step 1: Understand Angular's i18n extraction

   Angular extracts text marked with i18n for translation and uses the description (after @@) to help translators identify the text.

2. Step 2: Analyze the given code

   The text 'Hello, user!' will be extracted with the description 'titleDesc' for translation files. No syntax error occurs because @@ is valid for description keys.

3. Final Answer:

   Extract 'Hello, user!' for translation with the description 'titleDesc' -> Option C

4. Quick Check:

   i18n extracts text with description = Extract 'Hello, user!' for translation with the description 'titleDesc' [OK]

Hint: @@ means description key for translators in i18n [OK]

Common Mistakes:

• Thinking @@ causes syntax errors
• Assuming text is not extracted for translation
• Believing i18n attribute is ignored at build

4. Identify the error in this Angular template snippet for translation:

<button i18n="Submit button">Submit</button>

medium

A. The i18n attribute should be written as i18n-desc

B. The description should be inside @@, like i18n="@@Submit button"

C. The text 'Submit' should be inside double curly braces {{}}

D. The i18n attribute must be on a <span>, not a <button>

Solution

1. Step 1: Check the i18n attribute format

   The description or meaning for translation keys must be prefixed with @@ inside the i18n attribute, e.g., i18n="@@Submit button".

2. Step 2: Validate other options

   i18n can be used on any element, including button. Text does not require curly braces for static content. The attribute i18n-desc is not valid.

3. Final Answer:

   The description should be inside @@, like i18n="@@Submit button" -> Option B

4. Quick Check:

   Description needs @@ prefix in i18n attribute [OK]

Hint: Descriptions in i18n need @@ prefix inside quotes [OK]

Common Mistakes:

• Omitting @@ prefix for descriptions
• Thinking i18n only works on <span> elements
• Using i18n-desc instead of i18n

5. You want to mark multiple pieces of text in an Angular template for translation, each with a unique description. Which approach correctly applies this?

hard

A. Welcome
This is the intro paragraph.

B. Welcome
This is the intro paragraph.

C. Welcome
This is the intro paragraph.

D. Welcome
This is the intro paragraph.

Solution

1. Step 1: Use unique descriptions with @@ in i18n attribute

   Angular uses the syntax i18n="@@description" to add unique descriptions for each translatable text.

2. Step 2: Evaluate each option

   Welcome

   This is the intro paragraph.

   correctly uses i18n="@@headerDesc" and i18n="@@introDesc".

   Welcome

   This is the intro paragraph.

   uses invalid i18n-desc.

   Welcome

   This is the intro paragraph.

   misses @@ prefix.

   Welcome

   This is the intro paragraph.

   uses plain text instead of description keys.

3. Final Answer:

   <h2 i18n="@@headerDesc">Welcome</h2> <p i18n="@@introDesc">This is the intro paragraph.</p> -> Option A

4. Quick Check:

   Use i18n="@@uniqueDescription" for each text [OK]

Hint: Use @@ prefix in i18n for unique translation descriptions [OK]

Common Mistakes:

• Using i18n-desc instead of i18n
• Omitting @@ prefix for descriptions
• Putting descriptions as plain text in i18n attribute