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ỏ.
- Tệp giao diện:
components/product_item.html
Biến đầu vào
Component đọc biến có sẵn tại chỗ chèn. Những biến dưới đây phải tồn tại, nếu không component sẽ dựng ra khối rỗng.
| Biến | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
product |
Product |
có | Sản phẩm cần hiển thị; luôn lấy từ biến vòng lặp {% for product in ... %}. |
Cách chèn
{% for product in featured_products %}
{% include 'components/product_item' %}
{% endfor %}
Đường dẫn trong {% include %} tính từ gốc bộ giao diện và không có đuôi .html.
Mã đầy đủ
Toàn bộ tệp components/product_item.html của bộ giao diện mặc định.
{% comment %}
Thẻ sản phẩm dùng chung cho trang danh mục, tìm kiếm và các section.
Sản phẩm dùng đường dẫn riêng của chính nó: {{ product.url | escape }}.
Khi product.url trống (sản phẩm chưa có đường dẫn), hiển thị dạng chữ
thay vì tạo liên kết hỏng.
Tuỳ chọn: card_eager = true để ảnh không lazy-load (thẻ đầu màn hình).
{% endcomment %}
{%- assign pc_second = nil -%}
{%- if settings.show_second_image != false -%}
{%- if product.images.size > 1 -%}{%- assign pc_second = product.images[1].url -%}{%- endif -%}
{%- endif -%}
{%- assign pc_brand = product.brand.title -%}
<div class="product-card{% if pc_second %} product-card--has-second{% endif %}">
{% if product.url %}<a href="{{ product.url | escape }}" class="product-card__img-link" tabindex="-1" aria-hidden="true">{% else %}<span class="product-card__img-link">{% endif %}
{% if product.cover_image_url %}
<img src="{{ product.cover_image_url | escape }}" alt="{{ product.title | escape }}"
class="product-card__img" width="600" height="600" {% if card_eager %}fetchpriority="high"{% else %}loading="lazy"{% endif %} decoding="async">
{% if pc_second %}<img src="{{ pc_second | escape }}" alt="" class="product-card__img product-card__img--second" width="600" height="600" loading="lazy" decoding="async">{% endif %}
{% else %}
<span class="product-card__img-placeholder">{{ 'product-1' | placeholder_svg: 'placeholder-svg' }}</span>
{% endif %}
{% if product.compare_at_price and product.compare_at_price > product.price %}
<span class="product-card__badge">Giảm giá</span>
{% elsif product.compare_at_price %}
<span class="product-card__badge">Sale</span>
{% endif %}
{% if product.url %}</a>{% else %}</span>{% endif %}
<div class="product-card__body">
{% if settings.show_vendor != false and pc_brand %}<p class="product-card__vendor">{{ pc_brand | escape }}</p>{% endif %}
{% if product.url %}
<a href="{{ product.url | escape }}" class="product-card__name">{{ product.title | escape }}</a>
{% else %}
<span class="product-card__name">{{ product.title | escape }}</span>
{% endif %}
<div class="product-card__price">
{% if product.compare_at_price %}
<span class="price price--sale">{{ product.price | default: 0 | money }}</span>
<span class="price price--original"><span class="visually-hidden">Giá gốc </span>{{ product.compare_at_price | money }}</span>
{% else %}
<span class="price">{{ product.price | default: 0 | money }}</span>
{% endif %}
</div>
<button type="button" class="btn btn--outline btn--sm btn--block quick-add"
data-product-slug="{{ product.slug | escape }}"{% if product.url %} data-product-url="{{ product.url | escape }}"{% endif %}{% if product.default_variant_id %} data-variant-id="{{ product.default_variant_id | escape }}"{% endif %}>
Thêm vào giỏ<span class="visually-hidden">: {{ product.title | escape }}</span>
</button>
</div>
</div>
Dùng ở
| Trang |
|---|
home/index |
product/index |
product/detail |
product/category |
product/collection-detail |
product/search |
Trường được dùng
Component chỉ đọc những trường này của Product. Sửa component để đọc thêm trường khác thì nhớ cập nhật catalog/components.yaml.
product.urlproduct.cover_image_urlproduct.titleproduct.priceproduct.compare_at_priceproduct.slugproduct.imagesproduct.brandproduct.default_variant_id