Component

Component là một tệp giao diện đặt trong thư mục components/ của bộ giao diện, dùng lại được ở nhiều trang bằng thẻ {% include %}:

{% include 'components/product_item' %}

Khác với slot, component không nhận biến riêng từ máy chủ. Nó đọc biến đang có sẵn trong phạm vi tại chỗ chèn — thường là biến của một vòng lặp {% for %}. Vì vậy mỗi component có một hợp đồng đầu vào: danh sách biến phải tồn tại trước khi chèn.

Trang của từng component ghi rõ hợp đồng đó, kèm mã đầy đủ sẵn sàng chép.

Mục Mô tả
components/product_item Thẻ sản phẩm dùng trong mọi lưới sản phẩm: ảnh, tên, giá gạch ngang và nút thêm vào giỏ.
components/placeholder_card Thẻ sản phẩm mẫu (ảnh minh hoạ placeholder_svg) khi cửa hàng chưa có sản phẩm; dùng trong các section.
components/article_card Thẻ bài viết: ảnh, ngày đăng, tiêu đề, tóm tắt. Dùng trong section Bài viết nổi bật, Danh sách bài viết, Nội dung bài viết.
components/media_src In đường dẫn ảnh của thiết lập image_picker: URL đầy đủ giữ nguyên, tên tệp giao diện đi qua asset_url. Truyền vào: {% include 'components/media_src', src: ... %}.
components/social_links Danh sách liên kết mạng xã hội từ thiết lập giao diện social_facebook, social_youtube, social_tiktok, social_zalo, social_instagram.
components/icon Biểu tượng nét (truck, shield, return, support, payment, gift, star, store, clock, check). Truyền vào: {% include 'components/icon', icon: 'truck' %}.