Bạn biết tôi qua Upwork? Nếu bạn biết tôi qua Upwork và muốn sử dụng dịch vụ, vui lòng liên hệ qua Upwork. Tin nhắn từ khách Upwork gửi ngoài Upwork sẽ không được trả lời.
Ghi chú bản địa hóa🌏 Bản địa hóa

Bản địa hóa ứng dụng Angular sang tiếng Việt: XLIFF và locale

Bản địa hóa ứng dụng Angular sang tiếng Việt: trích xuất XLIFF, cấu hình locale vi, dùng Angular pipe định dạng VND và ngày tháng DD/MM/YYYY.

Dao Huy (Lucas)8 phút đọc8 mục
Bản địa hóa ứng dụng Angular sang tiếng Việt: XLIFF và locale

💡 Để bản địa hóa ứng dụng Angular sang tiếng Việt: cài @angular/localize, đánh dấu chuỗi template với thuộc tính i18n, chạy ng extract-i18n để tạo file XLIFF messages.xlf, dịch sang tiếng Việt, khai báo locale vi trong angular.json và build với ng build --localize. Điểm đơn giản hóa quan trọng: tiếng Việt chỉ có một dạng số nhiều ICU, nên chuỗi số nhiều chỉ cần một nhánh other duy nhất.

Ý chính

  • Pipeline i18n tích hợp của Angular dùng biên dịch AOT: chuỗi đánh dấu với i18n được thay thế lúc build, tạo ra một bản build riêng cho mỗi locale mà không tốn overhead runtime.
  • Chạy ng extract-i18n --output-path src/locale để tạo messages.xlf. Sao chép và đổi tên thành messages.vi.xlf, rồi điền các phần tử <target> bằng tiếng Việt.
  • Tiếng Việt chỉ có một dạng số nhiều CLDR: other. File XLIFF tiếng Việt không bao giờ cần nhánh one. Chỉ dùng selector chính xác =0 và =1 cho các trường hợp đặc biệt.
  • Đăng ký dữ liệu locale với registerLocaleData(localeVi) và cung cấp LOCALE_ID: 'vi'. Các pipe DatePipe, CurrencyPipe và DecimalPipe của Angular tự định dạng VND, ngày DD/MM/YYYY và dấu phân cách hàng nghìn bằng dấu chấm.
  • Chuỗi UI tiếng Việt dài hơn tiếng Anh 10-20%. Kiểm tra tất cả nhãn nút, tab điều hướng và viewport di động trước khi phát hành.

Pipeline i18n tích hợp của Angular hoạt động như thế nào?

Angular cung cấp toàn bộ pipeline quốc tế hóa trong package @angular/localize. Khác với các thư viện i18n runtime thay chuỗi trên trình duyệt, Angular biên dịch một bản build riêng cho mỗi locale. Angular CLI trích xuất chuỗi đánh dấu vào file XLIFF, hợp nhất XLIFF đã dịch lúc build, và xuất thư mục riêng cho từng ngôn ngữ.

Kết quả là triển khai thuần tĩnh: mỗi bản build locale chứa chính xác chuỗi cần thiết mà không có logic chuyển locale runtime. Thư mục vi/ có thể phục vụ từ CDN hoặc host tĩnh mà không cần phát hiện ngôn ngữ phía server.

Hướng dẫn i18n chính thức của Angular bao gồm toàn bộ pipeline từ thiết lập đến triển khai, bao gồm cách xử lý ID không khớp khi chuỗi nguồn thay đổi giữa các phiên bản.

Trích xuất file XLIFF và viết bản dịch tiếng Việt

Thêm package localize vào dự án:

ng add @angular/localize

Đánh dấu chuỗi trong template với thuộc tính i18n. Cung cấp metadata ý nghĩa và mô tả để hỗ trợ dịch viên:

<h1 i18n="site title|Homepage heading">My Product</h1>
<img i18n-title title="Company logo" alt="Company logo" />

Trích xuất tất cả chuỗi đánh dấu:

ng extract-i18n --output-path src/locale

Lệnh này tạo src/locale/messages.xlf. Sao chép thành src/locale/messages.vi.xlf và thêm phần tử <target> bằng tiếng Việt:

<trans-unit id="introductionHeader" datatype="html">
  <source>My Product</source>
  <target>Sản phẩm của tôi</target>
</trans-unit>

XLIFF 1.2 là định dạng mặc định. Dùng --format xlf2 cho XLIFF 2.0. Cả hai tương thích với CAT tool như Trados Studio, memoQ và Smartcat, nên bạn có thể gửi file trực tiếp cho dịch viên tiếng Việt mà không cần công cụ tùy chỉnh.

Chuỗi ICU plural trong tiếng Việt đơn giản hóa thế nào?

Tiếng Anh cần hai dạng số nhiều CLDR: one (số ít) và other. Tiếng Việt chỉ cần other. Tiếng Việt diễn đạt số lượng qua loại từ và ngữ cảnh, không qua biến hình từ, nên mọi con số đều ánh xạ đến cùng một dạng.

Chuỗi plural trong template tiếng Anh:

<span i18n>{count, plural, =0 {No results} one {# result} other {# results}}</span>

Trở thành trong messages.vi.xlf:

<target>{VAR_PLURAL, plural, =0 {Không có kết quả} other {# kết quả}}</target>

Tiếng Việt nói "1 kết quả" và "5 kết quả" với cùng một dạng từ. Chỉ cần selector chính xác =0 và =1 cho các trường hợp đặc biệt như trạng thái rỗng. Điều này làm giảm phạm vi dịch thuật cho mọi chuỗi liên quan đến số lượng trong ứng dụng.

Mệnh đề ICU select của Angular hoạt động bình thường. Tiếng Việt không thay đổi các từ xung quanh để khớp với giới tính ngữ pháp, nên các mệnh đề select dịch từng tùy chọn trực tiếp mà không cần điều chỉnh thêm.

Ngày tháng, số và tiền tệ tiếng Việt: các pipe Angular định dạng thế nào?

Đăng ký dữ liệu locale tiếng Việt trong app.config.ts trước khi các pipe hoạt động đúng:

import { registerLocaleData } from '@angular/common';
import localeVi from '@angular/common/locales/vi';
registerLocaleData(localeVi, 'vi');

// Trong providers:
{ provide: LOCALE_ID, useValue: 'vi' }

Với locale vi đang hoạt động, các pipe của Angular tạo kết quả tiếng Việt chính xác:

  • DatePipe: {{ today | date:'shortDate' }} trả về 14/11/2026 (DD/MM/YYYY). Định dạng dài dùng tên tháng tiếng Việt.
  • DecimalPipe: {{ 1500000 | number }} trả về 1.500.000. Dấu chấm là dấu phân cách hàng nghìn; dấu phẩy là dấu thập phân trong tiếng Việt.
  • CurrencyPipe: {{ 250000 | currency:'VND' }} trả về 250.000 ₫. VND không có đơn vị thập phân.
  • PercentPipe: {{ 0.65 | percent }} trả về 65%. Tiếng Việt không dùng khoảng cách đặc biệt với ký hiệu phần trăm.

Các quy tắc định dạng này đến từ dự án Unicode CLDR, chuẩn chính thức cho quy tắc định dạng theo locale. Angular đóng gói dữ liệu CLDR cho vi trong @angular/common/locales/vi.

Build locale vi và kiểm tra bố cục tiếng Việt

Khai báo locale tiếng Việt trong angular.json tại khóa i18n của dự án, rồi build với ng build --localize:

"i18n": {
  "sourceLocale": "en-US",
  "locales": {
    "vi": { "translation": "src/locale/messages.vi.xlf" }
  }
}

CLI xuất ra dist/my-app/vi/ và tự điều chỉnh base href. Thêm cấu hình có tên để build riêng tiếng Việt: ng build --configuration=production,vi. Phục vụ từng locale từ thư mục con (/vi/) và cấu hình server hoặc CDN chuyển hướng theo Accept-Language.

Trước khi phát hành, chạy danh sách kiểm tra bố cục này với bản build tiếng Việt:

  • Kiểm tra tất cả nhãn nút và CTA ở viewport di động 375px và 390px. Cụm danh từ tiếng Việt mở rộng hơn so với khi tiếng Anh dùng động từ ngắn.
  • Kiểm tra tab, breadcrumb và tùy chọn dropdown. Danh từ tiếng Việt thường đa âm tiết trong khi tiếng Anh dùng từ đơn hoặc viết tắt.
  • Xác minh hỗ trợ font: tiếng Việt dùng dấu phụ kết hợp qua sáu dấu thanh và các biến thể móc/lưỡi liềm trên nguyên âm cơ sở. Kiểm tra hiển thị ký tự như ộ, ề, ầ, ắ, ự, ẫ trong mọi web font bạn tải. Font hệ thống trên Android, iOS, Windows và macOS hỗ trợ đầy đủ; bộ font web rút gọn có thể thiếu glyph tiếng Việt.
  • Angular tự thiết lập lang="vi" trên phần tử <html> khi locale được cấu hình đúng. Áp dụng thêm overflow-wrap: break-word trong CSS để xử lý thuật ngữ kỹ thuật dài trong container hẹp.

Tự làm hay thuê chuyên gia: ranh giới thực tế cho team Angular hướng đến Việt Nam

Công việc kỹ thuật - cài @angular/localize, đánh dấu chuỗi, chạy extraction, cấu hình angular.json - hoàn toàn có thể tự làm. Bất kỳ lập trình viên nào quen Angular CLI đều có thể hoàn thành thiết lập trong một ngày. Dịch máy xử lý tốt với khối lượng lớn chuỗi có cấu trúc: nhãn form, thông báo lỗi, tooltip và tài liệu trợ giúp.

Chuyên gia người Việt bản địa thực sự tạo ra giá trị ở: giọng điệu UI sản phẩm, nội dung marketing và từ vựng chuyên ngành. Tiếng Việt phân biệt văn phong trang trọng và thân mật, và sự lựa chọn này ảnh hưởng đến cảm giác chuyên nghiệp của sản phẩm đối với người dùng doanh nghiệp. Từ Hán-Việt (từ vựng có nguồn gốc từ tiếng Hán cổ điển) thể hiện chuyên môn trong tài chính, y tế và pháp luật - máy dịch thông thường mặc định dùng từ thuần Việt đơn giản hơn mà người review chuyên nghiệp đánh giá là chưa chính xác.

Cách phân chia thực tế cho hầu hết team Angular: dùng MT kết hợp post-editing cho phần lớn nội dung trợ giúp và thông báo lỗi, và thuê chuyên gia cho 50-100 chuỗi người dùng đọc mỗi phiên làm việc. Với sản phẩm B2B mà nhóm mua hàng Việt Nam sẽ đánh giá giao diện, hãy dự trù review toàn bộ bởi người bản ngữ trước khi ra mắt.

Với dịch thuật chuyên nghiệp Anh-Việt cho ứng dụng Angular và phần mềm B2B, dịch vụ bản địa hóa website tiếng Việt trên trang này xử lý cả dịch thuật và review kỹ thuật file XLIFF.

Câu hỏi thường gặp

Có thể dùng Trados, memoQ hay Smartcat để dịch file XLIFF của Angular không?

Được. XLIFF 1.2 (.xlf) là chuẩn mở được hỗ trợ bởi tất cả CAT tool lớn như Trados Studio, memoQ, Smartcat và Lokalise. Gửi trực tiếp file messages.vi.xlf cho dịch viên. Lưu ý dịch viên không được sửa thuộc tính id hay phần tử placeholder như <x id="INTERPOLATION"/>. Một số tool có bộ lọc XLIFF dành riêng cho Angular tự xử lý các placeholder này.

Sự khác biệt giữa XLIFF 1.2 và XLIFF 2.0 cho dự án tiếng Việt là gì?

Angular tạo XLIFF 1.2 theo mặc định (.xlf). Dùng ng extract-i18n --format xlf2 cho XLIFF 2.0 (.xlf2). XLIFF 2.0 có schema gọn hơn và hỗ trợ namespace tốt hơn. Sự khác biệt thực tế cho tiếng Việt là nhỏ: chọn định dạng mà CAT tool hoặc agency dịch thuật của bạn ưa thích. Cả hai đều hỗ trợ cú pháp ICU MessageFormat dùng trong Angular template.

Nên dùng 'vi' hay 'vi-VN' làm locale ID trong Angular?

Dùng vi. Angular có dữ liệu locale cho cả vi và vi-VN trong @angular/common/locales/, nhưng vi là thẻ BCP 47 chính và bao gồm tất cả người dùng tiếng Việt. Theo hướng dẫn thẻ ngôn ngữ của W3C, hãy dùng thẻ ngắn nhất xác định chính xác ngôn ngữ trừ khi cần phân biệt biến thể vùng. Dùng vi-VN chỉ khi thư viện bên thứ ba yêu cầu mã locale đầy đủ.

Làm sao test bản build tiếng Việt khi phát triển cục bộ?

Thêm cấu hình build có tên vi vào angular.json, rồi chạy ng serve --configuration=vi. Dev server phục vụ locale tiếng Việt theo đường dẫn đã cấu hình. Để kiểm tra tất cả locale đồng thời, chạy ng build --localize và dùng server tĩnh cục bộ để phục vụ thư mục dist/. Lệnh ng serve không hỗ trợ build nhiều locale runtime; dùng cách build-rồi-serve cho kiểm tra trước khi phát hành.

Điều gì xảy ra với chuỗi tiếng Việt khi chuỗi nguồn thay đổi sau khi extraction?

Khi chuỗi nguồn đã đánh dấu thay đổi, Angular tạo ID translation unit mới. ID cũ trong messages.vi.xlf trở thành không dùng, và ID mới chưa có <target>. Angular build sẽ cảnh báo về translation bị thiếu. Thêm ID tùy chỉnh với @@my-id: i18n="@@product-title". Điều này cho phép cập nhật chuỗi nguồn mà không làm mất bản dịch tiếng Việt, miễn là ý nghĩa ngữ nghĩa không thay đổi.

Nguồn tham khảo

Dao Huy (Lucas)
Dao Huy (Lucas)
Tốt nghiệp Trường Đại học Ngoại ngữ, Đại học Đà Nẵng. Ký cam kết chính xác trên mọi bản dịch có xác nhận (USCIS, IRCC).

Bài viết bởi Đào Huy (Lucas), biên dịch viên và chuyên viên bản địa hóa tiếng Việt (Anh, Trung, Pháp sang Việt). See translation services →

Báo giáWhatsApp