آنلاین

ارجاع به localeها با ID

Angular از locale identifier مربوط به Unicode \(Unicode locale ID\) استفاده می‌کند تا locale data درست را برای internationalization مربوط به text stringها پیدا کند.

یک locale ID زبان، کشور و یک code اختیاری را برای variantها یا subdivisionهای بیشتر مشخص می‌کند. locale ID از language identifier، یک کاراکتر hyphen \(-\) و locale extension تشکیل می‌شود.

html
{language_id}-{locale_extension}

کشورهای زیادی زبان یکسانی دارند، اما در usage متفاوت‌اند. این تفاوت‌ها شامل grammar، punctuation، formatهای currency، decimal numberها، dateها و موارد مشابه است.

برای مثال‌های این راهنما، از languageها و localeهای زیر استفاده کنید.

LanguageLocaleUnicode locale ID
EnglishCanadaen-CA
EnglishUnited States of Americaen-US
FrenchCanadafr-CA
FrenchFrancefr-FR

[Angular repository][GithubAngularAngularTreeMasterPackagesCommonLocales] شامل localeهای رایج است.

تنظیم source locale ID

از Angular CLI استفاده کنید تا source languageای را تنظیم کنید که component template و code را با آن می‌نویسید.

به صورت پیش‌فرض، Angular از en-US به عنوان source locale پروژه شما استفاده می‌کند.

برای تغییر source locale پروژه خود برای build، actionهای زیر را انجام دهید.

  1. فایل build configuration مربوط به workspace یعنی [angular.json][GuideWorkspaceConfig] را باز کنید.
  2. field مربوط به sourceLocale را داخل section مربوط به i18n اضافه یا modify کنید:
json
{
  "projects": {
    "your-project": {
      "i18n": {
        "sourceLocale": "ca" // Use your desired locale code
      }
    }
  }
}

قدم بعدی

[GuideWorkspaceConfig]: reference/configs/workspace-config 'Angular workspace configuration | Angular' [GithubAngularAngularTreeMasterPackagesCommonLocales]: https://github.com/angular/angular/tree/main/packages/common/locales 'angular/packages/common/locales | angular/angular | GitHub' [RfcEditorInfoBcp47]: https://www.rfc-editor.org/info/bcp47 'BCP 47 | RFC Editor' [UnicodeCldrDevelopmentCoreSpecification]: https://cldr.unicode.org/index/cldr-spec 'Core Specification | Unicode CLDR Project' [UnicodeCldrDevelopmentCoreSpecificationLocaleID]: https://cldr.unicode.org/index/cldr-spec/picking-the-right-language-code 'Unicode Language and Locale Identifiers - Core Specification | Unicode CLDR Project'