angularangular-i18n

How to use Angular i18n $localize with plurals?


Since Angular 9 we can use

$localize`Hello ${name}:name:`

For i18n in typescript code. This still has some limitations as the ng xi18n command does not detect the strings, but if these texts are added manually to the translation file it works.

The $localize function is quite well documented in the JSDoc in the source, however it does not explain how to work with plurals. What I mean is something like this (pseudo-code):

$localize`Hello {${count}, plural, =1 {reader} other {readers}}`

Is this possible with $localize? If yes: How? If no: How does Angular compile such expressions from HTML to TypeScript?


Solution

  • For now, it is not possible to use ICUs with $localize, as discussed in this github issue. From the last comments, it looks like angular team is considering it if it remains lightweight.

    Meanwhile, the suggested workaround is to create your own helper method that returns the correct translation based on the count parameter.

        title = $localize `Hi ${this.name}! You have ${
            plural(this.users.length. {
              0: $localize `no users`,
              1: $localize `one user`,
              other: $localize`${this.users.length} users`,
        }.`
    
        function plural(value, options) {
          // Handle 0, 1, ... cases
          const directResult = options[value];
          if (directResult !== undefined) { return directResult; }
          // handle zero, one, two, few, many
          // ...
          return options.other;
        }