Tác giả:
    Ngày tạo:2026-06-12Cập nhật lần cuối:2026-06-26

    Từ điển động

    Intlayer hỗ trợ hai cơ chế để diễn đạt nội dung vượt ra ngoài một từ điển tĩnh duy nhất cho mỗi khóa. Mỗi cơ chế được khai báo qua một trường metadata cấp cao nhất trong tệp nội dung; không cần hàm bao bọc.

    Tính năng Trường metadata Bộ chọn trong useIntlayer
    Bộ sưu tập item: N { item: N }
    Biến thể variant: "name" hoặc variant: { … } { variant: "name" } hoặc { variant: { … } }

    Cả hai đều kết hợp với đối số locale và hỗ trợ tải chọn lọc / lười qua importMode.

    Khi nào dùng cái nào

    • Bộ sưu tập — danh sách mục được sắp xếp, quản lý trong các tệp riêng (mục FAQ, bài blog, sản phẩm).
    • Biến thể — các lựa chọn nội dung được đặt tên hoặc có cấu trúc:
      • biến thể chuỗi cho thử nghiệm A/B, banner theo mùa hoặc feature flag;
      • biến thể đối tượng cho bản ghi CMS, nội dung riêng theo người dùng, hoặc bất kỳ nội dung nào được định địa chỉ bằng một tập hợp trường ("bản ghi động" trước đây).
    Các phiên bản trước cung cấp một trường meta riêng cho nội dung được khóa theo bản ghi. Nó đã được hợp nhất vào variant: hãy truyền một đối tượng cho variant thay vì dùng meta.

    Khử nhập nhằng bộ chọn

    Một khóa có thể khai báo cả hai chiều cùng lúc (ví dụ một bộ sưu tập mà mỗi mục có một biến thể). Chúng được phân giải theo thứ tự:

    plaintext
    variant → item

    Vì vậy, { variant: "promo" } trên khóa variant × item trả về mọi mục promo dưới dạng mảng, và thêm { item: 2 } thu hẹp lại còn một mục duy nhất.