若要運用 Angular 的在地化功能,請使用 Angular CLI 將 @angular/localize 套件新增至你的專案。
若要新增 @angular/localize 套件,請使用下列指令,更新專案中的 package.json 與 TypeScript 設定檔。
ng add @angular/localize
它會在 TypeScript 設定檔中加入 types: ["@angular/localize"]。
它也會在 main.ts 檔案頂部加入 /// <reference types="@angular/localize" /> 這一行,作為型別定義的參照。
HELPFUL: 關於 package.json 與 tsconfig.json 檔案的更多資訊,請見工作區 npm 相依性與 TypeScript 設定。若要了解 Triple-slash Directives,請造訪 TypeScript Handbook。
若未安裝 @angular/localize,而你嘗試建置專案的在地化版本(例如在範本中使用 i18n 屬性時),Angular CLI 會產生錯誤,錯誤訊息中會包含為專案啟用 i18n 的步驟。
選項
| 選項 | 說明 | 值型別 | 預設值 |
|---|---|---|---|
--project |
專案名稱。 | string |
|
--use-at-runtime |
設定後,$localize 即可在執行時使用。此外,@angular/localize 會被加入 package.json 的 dependencies 區段,而不是預設的 devDependencies。 |
boolean |
false |
更多可用選項,請見 Angular CLI 中的 ng add。