Fixes #2756.

Changelog Entry

Breaking changes

• Localization
  • locale prop: zh-YUE has been renamed to yue to conform with Unicode standard. zh-YUE will continue to work with warnings
  • Most strings are being retranslated by Microsoft localization team, except English (US), Egyptian Arabic, and Chinese Yue
    • If the new strings are undesirable, please use the overideLocalizedStrings prop to override
    • String IDs are being refreshed and use a standard format
  • useLocalize and useLocalizeDate is being deprecated. Please use useLocalizer and useLocalizerForDate instead

Added

• Resolves #2756. Improved localizability and add override support for localized strings, by @compulim in PR #2894
  • Will be translated into 44 languages, plus 2 community-contributed translations
  • For details, please read this documentation on the localization work

Description

Please see docs/LOCALIZATION.md for details.

Specific Changes

I am considering renaming useLocalizerForBytes into useByteFormatter, useDateFormatter, useRelativeTimeFormatter instead.

• Added new hooks useLocalizer, useLocalizerForBytes, useLocalizerForDate, and useLocalizerForRelativeTime
  • The newer useLocalizer will help reduce code and slightly improve performance
• Updated useLanguage hook to support outputting oral language, which can be different from written (UI) language
• Deprecating useLocalize and useLocalizeDate
• Move all components to use the new hooks
• Migrated all strings from .js into .json, before localization team has their strings ready
• Use globalize for I18n on date, time, and unit
• Pre-compile cldr-data into PrecompiledGlobalize.js (~140 KB for 44 languages)
• Bump Babel to 7.8 to support copying JSON files into /lib/ folder
• Added overrideableLocalizedStrings prop to allow developers to override our strings
• Moved inline render Markdown logic from <SendFailedRetry> to <InlineMarkdown>

To-do

• Run createPrecompiledGlobalize.js during npm run build
• Update Localize.js to use latest JSON files
• Remove *.js files
• Bump Babel to 7.8 on all packages
• Plural rules for toaster
• Move "Send failed. Retry." to use <InlineMarkdown>

• Testing Added