global
const
Tag a template literal string for localization.
const $localize: LocalizeFn;
For example:
$localize `some string to localize`
Providing meaning, description and id
You can optionally specify one or more of meaning
, description
and id
for a localized string by pre-pending it with a colon delimited block of the form:
$localize`:meaning|description@@id:source message text`; $localize`:meaning|:source message text`; $localize`:description:source message text`; $localize`:@@id:source message text`;
This format is the same as that used for i18n
markers in Angular templates. See the Angular 18n guide.
Naming placeholders
If the template literal string contains expressions, then the expressions will be automatically associated with placeholder names for you.
For example:
$localize `Hi ${name}! There are ${items.length} items.`;
will generate a message-source of Hi {$PH}! There are {$PH_1} items
.
The recommended practice is to name the placeholder associated with each expression though.
Do this by providing the placeholder name wrapped in :
characters directly after the expression. These placeholder names are stripped out of the rendered localized string.
For example, to name the items.length
expression placeholder itemCount
you write:
$localize `There are ${items.length}:itemCount: items`;
Escaping colon markers
If you need to use a :
character directly at the start of a tagged string that has no metadata block, or directly after a substitution expression that has no name you must escape the :
by preceding it with a backslash:
For example:
// message has a metadata block so no need to escape colon $localize `:some description::this message starts with a colon (:)`; // no metadata block so the colon must be escaped $localize `\:this message starts with a colon (:)`;
// named substitution so no need to escape colon $localize `${label}:label:: ${}` // anonymous substitution so colon must be escaped $localize `${label}\: ${}`
Processing localized strings:
There are three scenarios:
compile-time inlining: the $localize
tag is transformed at compile time by a transpiler, removing the tag and replacing the template literal string with a translated literal string from a collection of translations provided to the transpilation tool.
run-time evaluation: the $localize
tag is a run-time function that replaces and reorders the parts (static strings and expressions) of the template literal string with strings from a collection of translations loaded at run-time.
pass-through evaluation: the $localize
tag is a run-time function that simply evaluates the original template literal string without applying any translations to the parts. This version is used during development or where there is no need to translate the localized template literals.
© 2010–2021 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://v11.angular.io/api/localize/init/$localize