Dịch trang web Angular 19 (Webpack) của bạn bằng Intlayer | Quốc tế hóa (i18n)

Mục lục

Tại sao Intlayer thay thế các lựa chọn thay thế?

So với các giải pháp chính như ngx-translate hay angular-l10n, Intlayer là giải pháp đi kèm với các tính năng tối ưu hóa tích hợp như:

Hướng dẫn từng bước để thiết lập Intlayer trong ứng dụng Angular

Xem Mẫu ứng dụng trên GitHub.

1. 1

   Cài đặt các phụ thuộc

   Cài đặt các gói cần thiết bằng npm:

   bash

   Sao chép nội dung

   Sao chép mã

   Sao chép mã vào clipboard

   npx intlayer init --interactive
   

   cờ --interactive là tùy chọn. Sử dụng intlayer-cli init nếu bạn là tác nhân AI.

   Lệnh này sẽ phát hiện môi trường của bạn và cài đặt các gói cần thiết. Ví dụ:

   bash

   Sao chép nội dung

   Sao chép mã

   Sao chép mã vào clipboard

   npm install intlayer angular-intlayer
   npm install @angular-builders/custom-webpack --save-dev
   

   • intlayer

     Gói cốt lõi cung cả các công cụ quốc tế hóa để quản lý cấu hình, dịch thuật, khai báo nội dung, chuyển đổi mã (transpilation) và các lệnh CLI.

   • angular-intlayer Gói tích hợp Intlayer với ứng dụng Angular. Nó cung cấp các trình cung cấp ngữ cảnh (context providers) và các hook cho quốc tế hóa Angular.

   • @angular-builders/custom-webpack Yêu cầu để tùy chỉnh cấu hình Webpack của Angular CLI.

2. 2

   Cấu hình dự án của bạn

   Tạo một tệp cấu hình để thiết lập các ngôn ngữ cho ứng dụng của bạn:

   intlayer.config.ts

   Sao chép nội dung

   Sao chép mã

   Sao chép mã vào clipboard

   import { Locales, type IntlayerConfig } from "intlayer";
   
   const config: IntlayerConfig = {
     internationalization: {
       locales: [
         Locales.ENGLISH,
         Locales.FRENCH,
         Locales.SPANISH,
         // Các ngôn ngữ khác của bạn
       ],
       defaultLocale: Locales.ENGLISH,
     },
   };
   
   export default config;
   

   Thông qua tệp cấu hình này, bạn có thể thiết lập các URL được bản địa hóa, điều hướng middleware, tên cookie, vị trí và phần mở rộng của các khai báo nội dung, tắt nhật ký Intlayer trong bảng điều khiển, v.v. Để biết danh sách đầy đủ các tham số có sẵn, hãy tham khảo tài liệu cấu hình.

3. 3

   Tích hợp Intlayer vào cấu hình Angular của bạn

   Để tích hợp Intlayer với Angular CLI, bạn cần sử dụng một trình xây dựng (builder) tùy chỉnh. Hướng dẫn này giả định bạn đang sử dụng Webpack (mặc định cho nhiều dự án Angular).

   Đầu tiên, sửa đổi tệp angular.json của bạn để sử dụng trình xây dựng Webpack tùy chỉnh. Cập nhật các cấu hình build và serve:

   angular.json

   Sao chép nội dung

   Sao chép mã

   Sao chép mã vào clipboard

   {
     "projects": {
       "your-app-name": {
         "architect": {
           "build": {
             "builder": "@angular-builders/custom-webpack:browser", // replace "@angular-devkit/build-angular:application",
             "options": {
               "customWebpackConfig": {
                 "path": "./webpack.config.ts",
                 "mergeStrategies": { "module.rules": "prepend" },
               },
               "main": "src/main.ts", // replace "browser": "src/main.ts",
               // ...
             },
           },
           "serve": {
             "builder": "@angular-builders/custom-webpack:dev-server",
           },
         },
       },
     },
   }
   

   Đảm bảo thay thế your-app-name bằng tên thực tế của dự án bạn trong angular.json.

   Tiếp theo, tạo một tệp webpack.config.ts tại thư mục gốc của dự án:

   webpack.config.ts

   Sao chép nội dung

   Sao chép mã

   Sao chép mã vào clipboard

   import { mergeConfig } from "angular-intlayer/webpack";
   
   export default mergeConfig({});
   

   Hàm mergeConfig cấu hình Webpack với Intlayer. Nó chèn IntlayerPlugin (để xử lý các tệp khai báo nội dung) và thiết lập các biệt danh (aliases) để đạt hiệu suất tối ưu.

4. 4

   Khai báo nội dung của bạn

   Tạo và quản lý các khai báo nội dung để lưu trữ các bản dịch:

   Các khai báo nội dung của bạn có thể được định nghĩa ở bất kỳ đâu trong ứng dụng miễn là chúng được bao gồm trong thư mục contentDir (mặc định là ./src) và khớp với phần mở rộng tệp khai báo nội dung (mặc định là .content.{json,ts,tsx,js,jsx,mjs,cjs,md,mdx,yaml,yml}).

   Để biết thêm chi tiết, hãy tham khảo tài liệu khai báo nội dung.

5. 5

   Sử dụng Intlayer trong mã của bạn

   Để sử dụng các tính năng quốc tế hóa của Intlayer trong toàn bộ ứng dụng Angular của bạn, bạn cần cung cấp Intlayer trong cấu hình ứng dụng.

   src/app/app.config.ts

   Sao chép nội dung

   Sao chép mã

   Sao chép mã vào clipboard

   import { ApplicationConfig } from "@angular/core";
   import { provideRouter } from "@angular/router";
   import { provideIntlayer } from "angular-intlayer";
   import { routes } from "./app.routes";
   
   export const appConfig: ApplicationConfig = {
     providers: [
       provideRouter(routes),
       provideIntlayer(), // Thêm provider Intlayer tại đây
     ],
   };
   

   Sau đó, bạn có thể sử dụng hàm useIntlayer bên trong bất kỳ thành phần (component) nào.

   src/app/app.component.ts

   Sao chép nội dung

   Sao chép mã

   Sao chép mã vào clipboard

   import { Component } from "@angular/core";
   import { RouterOutlet } from "@angular/router";
   import { useIntlayer } from "angular-intlayer";
   
   @Component({
     selector: "app-root",
     standalone: true,
     imports: [RouterOutlet],
     templateUrl: "./app.component.html",
     styleUrl: "./app.component.css",
   })
   export class AppComponent {
     content = useIntlayer("app");
   }
   

   Và trong template của bạn:

   src/app/app.component.html

   Sao chép nội dung

   Sao chép mã

   Sao chép mã vào clipboard

   <div class="content">
     <h1>{{ content().title }}</h1>
     <p>{{ content().congratulations }}</p>
   </div>
   

   Nội dung Intlayer được trả về dưới dạng một Signal, vì vậy bạn truy cập các giá trị bằng cách gọi signal đó: content().title.

6. 6

   Thay đổi ngôn ngữ nội dung của bạn

   Tùy chọn

   Để thay đổi ngôn ngữ của nội dung, bạn có thể sử dụng hàm setLocale được cung cấp bởi hàm useLocale. Điều này cho phép bạn thiết lập ngôn ngữ của ứng dụng và cập nhật nội dung tương ứng.

   Tạo một thành phần để chuyển đổi giữa các ngôn ngữ:

   src/app/locale-switcher.component.ts

   Sao chép nội dung

   Sao chép mã

   Sao chép mã vào clipboard

   import { Component } from "@angular/core";
   import { CommonModule } from "@angular/common";
   import { useLocale } from "angular-intlayer";
   
   @Component({
     selector: "app-locale-switcher",
     standalone: true,
     imports: [CommonModule],
     template: `
       <div class="locale-switcher">
         <select
           [value]="locale()"
           (change)="setLocale($any($event.target).value)"
         >
           @for (loc of availableLocales; track loc) {
             <option [value]="loc">{{ loc }}</option>
           }
         </select>
       </div>
     `,
   })
   export class LocaleSwitcherComponent {
     localeCtx = useLocale();
   
     locale = this.localeCtx.locale;
     availableLocales = this.localeCtx.availableLocales;
     setLocale = this.localeCtx.setLocale;
   }
   

   Sau đó, sử dụng thành phần này trong app.component.ts của bạn:

   src/app/app.component.ts

   Sao chép nội dung

   Sao chép mã

   Sao chép mã vào clipboard

   import { Component } from "@angular/core";
   import { RouterOutlet } from "@angular/router";
   import { useIntlayer } from "angular-intlayer";
   import { LocaleSwitcherComponent } from "./locale-switcher.component";
   
   @Component({
     selector: "app-root",
     standalone: true,
     imports: [RouterOutlet, LocaleSwitcherComponent],
     templateUrl: "./app.component.html",
     styleUrl: "./app.component.css",
   })
   export class AppComponent {
     content = useIntlayer("app");
   }
   

Cấu hình TypeScript

Intlayer sử dụng tăng cường mô-đun (module augmentation) để tận dụng lợi ích của TypeScript và giúp mã nguồn của bạn mạnh mẽ hơn.

Đảm bảo cấu hình TypeScript của bạn bao gồm các kiểu dữ liệu được tự động tạo.

{
  // ... Các cấu hình TypeScript hiện có của bạn
  "include": [
    // ... Các cấu hình TypeScript hiện có của bạn
    ".intlayer/**/*.ts", // Bao gồm các kiểu dữ liệu được tạo tự động
  ],
}

Cấu hình Git

Khuyên dùng bỏ qua các tệp được tạo bởi Intlayer. Điều này giúp bạn tránh việc commit chúng vào kho lưu trữ Git của mình.

Để thực hiện việc này, bạn có thể thêm các hướng dẫn sau vào tệp .gitignore của mình:

#  Bỏ qua các tệp được tạo bởi Intlayer
.intlayer

Tiện ích mở rộng VS Code

Để cải thiện trải nghiệm phát triển của bạn với Intlayer, bạn có thể cài đặt Tiện ích mở rộng Intlayer cho VS Code chính thức.

Cài đặt từ VS Code Marketplace

Tiện ích mở rộng này cung cấp:

• Tự động hoàn thành cho các khóa dịch.
• Phát hiện lỗi thời gian thực cho các bản dịch còn thiếu.
• Xem trước trực tiếp nội dung đã dịch.
• Các hành động nhanh (Quick actions) để dễ dàng tạo và cập nhật các bản dịch.

Để biết thêm chi tiết về cách sử dụng tiện ích mở rộng, hãy tham khảo tài liệu Tiện ích mở rộng Intlayer cho VS Code.

Đi xa hơn

Để tìm hiểu thêm, bạn có thể triển khai trình chỉnh sửa trực quan (visual editor) hoặc xuất nội dung của bạn bằng cách sử dụng CMS.

Các Câu Hỏi Thường Gặp