Handles

Handles được sử dụng để truy cập các đối tượng của Liquid. Mặc định, nó là tên của đối tượng bằng chữ thường với các khoảng trống và các ký tự đặc biệt được thay thế bởi dấu gạch ngang (-). Mọi đối tượng trong Liquid (sản phẩm, bộ sưu tập, blog, danh sách đường dẫn ) đều có handle. Ví dụ, một trang có tiêu đề “About Us” có thể được truy cập ở Liquid thông qua handle liquid about-us được thể hiện như sau:

the content of the About Us page
{{ pages.about-us.content }}

Handles của tôi được tạo ra như thế nào?

Một sản phẩm với tên “Harvan Product” sẽ tự động được gán handle là haravan-product. Nếu đã có một sản phẩm với tên “Harvan Product”, handle sẽ tự động điền thêm ký tự khác. Nói cách khác, tất cả các sản phẩm “Harvan Product” được tạo ra sau khi cái đầu tiên được tạo, sẽ nhận tên haravan-product-1, haravan-product-2, v.v..

Những khoảng trống trong tên được thay thế bởi dấu ghạch ngang trong handle. Ví dụ: một tên là “Sản phẩm Haravan” sẽ cho kết quả một handle là san-pham-harvan.

Tên này cũng sẽ quyết định URL của đối tượng đó. Ví dụ: một trang với handle là “Về haravan” sẽ có liên kết: http://tenshop.myharavan.com/pages/ve-haravan Những thiết kế dành cho cửa hàng thường dựa vào một handle không thay đổi đối với một trang, một sản phẩm hoặc một danh mục đường dẫn. Để duy trì cơ sở thiết kế và tránh làm đứt đường dẫn, nếu bạn thay đổi tên của một đối tượng, Haravan sẽ không tự động cập nhật handle. Ví dụ nếu bạn thay đổi tựa đề trang của bạn từ “Về Haravan” thành “Về chúng tôi”…

...handle của bạn sẽ vẫn là ve-haravan

Tuy nhiên, bạn có thể thay đổi thủ công một handle của một đối tượng bằng cách thay đổi đường dẫn trong phần nội dụng của "Đường dẫn"

Truy cập các thuộc tính thông qua handle

Trong nhiều trường hợp bạn có thể biết hanlde các thuộc tính của đối tượng mà bạn muốn truy cập. Bạn có thể truy cập các thuộc tính của đó bằng cách dùng tên của đối tượng, sau đó sử dụng ký tự ngoặc vuông([ ]) hoặc dâu chấm (.) Đầu vào

{{ pages.ve-haravan.title }} 
{{ pages["ve-haravan"].title }}

Đầu ra

Về Haravan
Về Haravan

Chú ý: ví dụ này sử dụng "pages" thay vì "page".

Một ví dụ khác:

{% for product in collections[settings.sanpham-haravan].products %}
    {{ product.title }}
{% endfor %}