--- createdAt: 2026-08-29 updatedAt: 2026-09-27 priority: 9 title: "htmx i18n - Hướng dẫn hoàn chỉnh dịch ứng dụng của bạn" description: "Dùng Intlayer với htmx: render đoạn HTML đã dịch trên server, nhận diện locale theo từng request và đổi ngôn ngữ không cần SPA." keywords: - Internationalization - Documentation - Intlayer - htmx - Hypermedia - JavaScript - Backend slugs: - doc - environment - htmx history: - version: 9.4.1 date: 2026-08-29 changes: "Initial history" author: aymericzip --- # Dịch ứng dụng htmx của bạn bằng Intlayer htmx không render bất kỳ nội dung nào của riêng nó. Mọi nhãn mà khách truy cập đọc được đều là HTML mà máy chủ của bạn tạo ra, và mọi swap là một yêu cầu HTTP riêng biệt. Quốc tế hóa một ứng dụng htmx do đó là một mối quan tâm của máy chủ: locale phải được giải quyết trên mỗi yêu cầu, và mỗi fragment phải được render ở locale đó. Intlayer giải quyết điều này thông qua các backend integrations của nó, chúng phát hiện locale cho mỗi yêu cầu và expose nội dung khai báo của bạn cho handler xây dựng HTML. ## Mục lục ## Ba quy tắc của i18n trong một ứng dụng htmx Một trang có thể kích hoạt hàng chục swaps. Mỗi cái là một yêu cầu mới không có bộ nhớ về trang đã phát hành nó. Nếu locale nằm trong một biến được đặt trong quá trình render ban đầu, mọi fragment sau đó sẽ quay lại ngôn ngữ mặc định. Middleware Intlayer giải quyết locale từ chính yêu cầu đó, vì vậy một fragment được phục vụ tại phút mười trả lời cùng ngôn ngữ với trang được phục vụ tại phút không. Hai trình vận chuyển hoạt động với htmx. Một cookie (`INTLAYER_LOCALE`) được gửi bởi trình duyệt tự động trên mỗi yêu cầu, bao gồm các yêu cầu htmx. Một header (`x-intlayer-locale`) có thể được đính kèm vào các yêu cầu htmx với thuộc tính `hx-headers`. Cả hai đều được đọc theo mặc định. Một giá trị được dịch nội suy vào một fragment là markup. Escape nó, giống như bạn sẽ làm với bất kỳ giá trị động nào khác, vì vậy một bản dịch chứa `<` không thể phá vỡ tài liệu mà nó được hoán đổi vào. ## Hướng Dẫn Từng Bước