ember-intl

Appearance

Migration from v4 to v5

Obsolete ​

The locales, disablePolyfill, and autoPolyfill configuration options in config/ember-intl.js are no longer used and can be safely removed.

Breaking Changes ​

Translations ​

Improved ICU-spec compliance, special characters are now escaped via a single quote ' instead of a slash \.

NOTE: This change is advised for all future translations, however \ escaping is backwards-compatible starting with the v5.5.0 release.

Node runtime ​

We now support down to Node 10, dropping support for Node 8.

Polyfilling ​

This addon no longer provides polyfills "out of the box." The reasoning, along with the current browser requirements, can be found in the section.

I highly encourage you read through all the browser support matrices within the to ensure it aligns with your projects runtime targets.

lookup() missing translations ​

intl.lookup() will no longer return "Missing translations" or emit any runtime warnings. If a translation is missing, undefined is returned from the method.

NOTE: This does not impact intl.t() or the {{t}} API for when missing translations occurs. Missing translation behavior for those flows remains the same as found in 4.x.

Intl.RelativeTimeFormat ​

When we introduced FormatRelative, the spec for Intl.RelativeTimeFormat was still under development. It has now reached stage 3 and multiple browsers have implemented it. However, the API is quite different from the spec we had implemented so we've had to adjust the API to match the spec which means it's not backwards compatible.

Changes:

  • units is now unit
  • style becomes numeric (the default)
  • Type of value is no longer a Date instance but rather delta in the specified unit
  • interval was removed from the format-relative helper
  • now was removed from the format-relative helper

Compact Number Formatter ​

In 4.x, we introduced a shortNumber formatter. This is no longer necessary as we can rely on the native Intl.NumberFormat to compact numbers into their abbreviated form.

{numCustomers, shortNumber}

becomes

{numCustomers, number, compact}

or

{{format-number numCustomers notation="compact"}}