Tema etiketleri
Bir tema şablonunun kullanabildiği Liquid etiketleri.
Bu liste tema motoruna kayıtlı etiketlerdir. Bilinmeyen bir etiket biticaret theme check ve yükleme için hatadır.
Çizim sırasında bir etiketteki hata sayfayı durdurmaz: o etiketin yerine Liquid error (sections/x.liquid line 3): … yazılır ve sayfanın kalanı çizilir.
Tema etiketleri
| Etiket | Ne yapar | Örnek |
|---|---|---|
section |
Bir bölümü adıyla çizer. | {% section 'header' %} |
sections |
Bir bölüm grubunu çizer. | {% sections 'header-group' %} |
content_for |
Tema bloklarını çizer: 'blocks' hepsini, 'block' birini. |
{% content_for 'blocks' %} |
render |
Bir parçayı (snippets/) kendi değişkenleriyle çizer; with, for ve as alır. |
{% render 'product-card', product: product %} |
include |
render'ın eski hali; çağıranın değişkenlerini görür. Yeni kodda render kullanın. |
{% include 'product-card' %} |
layout |
Şablonun düzenini seçer; none düzensiz çizer. |
{% layout 'password' %} |
form |
Platformun bir formunu, doğru adres ve gizli alanlarla açar. | {% form 'product', product %}…{% endform %} |
paginate |
Bir listeyi sayfalara böler ve paginate nesnesini verir. |
{% paginate collection.products by 24 %}…{% endpaginate %} |
schema |
Bölümün veya bloğun ayar tanımı (JSON); çıktı vermez. | {% schema %}{ "name": "…" }{% endschema %} |
style |
İçeriğini bir <style> öğesinde yazar; içinde Liquid çalışır. |
{% style %}:root { --page-width: {{ settings.page_width }}px; }{% endstyle %} |
stylesheet |
Bölümün CSS'i; temanın paketine derlenir, yerinde çıktı vermez. | {% stylesheet %}.card { … }{% endstylesheet %} |
javascript |
Bölümün JavaScript'i; temanın paketine derlenir, yerinde çıktı vermez. | {% javascript %}…{% endjavascript %} |
form türleri
| Tür | Adres |
|---|---|
product |
/cart/add |
cart |
/cart |
contact, customer |
/contact |
localization |
/localization |
currency |
/cart/update |
storefront_password |
/password |
customer_login, guest_login |
/account/login |
create_customer |
/account |
recover_customer_password |
/account/recover |
reset_customer_password |
/account/reset |
activate_customer_password |
/account/activate |
customer_address |
/account/addresses |
new_comment |
/comments |
create_customer, recover_customer_password, reset_customer_password, activate_customer_password ve new_comment formları çizilir ama platform bu adreslere gönderim almaz: müşteriler şifreyle değil e-postalarına gelen kodla giriş yapar ve blog yorumları yoktur. customer_login formu yalnızca email (veya customer[email]) alanını okur ve giriş kodunu gönderir.
Müşterinin hesabını değiştiren veya mesaj gönderen formlar (iletişim, giriş, adres) giriş yapmış müşteri için gizli bir authenticity_token alanı taşır; misafirin gönderimleri adresin geldiği sayfayla denetlenir. Sepet, ürün, para birimi ve localization formları belirteç taşımaz, yalnızca mağazanın kendi sayfalarından kabul edilir.
{%- form 'product', product, class: 'form' -%}
<input type="hidden" name="id" value="{{ current.id }}">
<label>{{ 'products.product.quantity' | t }} <input type="number" name="quantity" value="1" min="1"></label>
<button class="button" type="submit">{{ 'products.product.add_to_cart' | t }}</button>
{%- endform -%}
Değişkenler
| Etiket | Ne yapar | Örnek |
|---|---|---|
assign |
Bir değişken tanımlar. | {% assign current = product.selected_or_first_available_variant %} |
capture |
İçeriğini bir değişkene yazar. | {% capture label %}{{ product.title }}{% endcapture %} |
increment |
Bir sayacı yazar ve bir artırır. | {% increment counter %} |
decrement |
Bir sayacı bir azaltır ve yazar. | {% decrement counter %} |
echo |
{{ … }} gibi yazar; {% liquid %} içinde kullanılır. |
{% echo product.title %} |
liquid |
Birden çok etiketi ayraçsız, satır satır yazar. | Aşağıda |
{%- liquid
assign featured = section.settings.collection
if featured == blank
assign featured = collections.all
endif
-%}
Koşullar
| Etiket | Ne yapar | Örnek |
|---|---|---|
if, elsif, else |
Koşul doğruysa çizer. | {% if product.available %}…{% else %}…{% endif %} |
unless |
Koşul yanlışsa çizer. | {% unless variant.available %} disabled{% endunless %} |
case, when, else |
Bir değere göre dallanır. | {% case template.name %}{% when 'product' %}…{% endcase %} |
ifchanged |
İçeriği önceki turdakinden farklıysa çizer. | {% ifchanged %}{{ product.vendor }}{% endifchanged %} |
Döngüler
| Etiket | Ne yapar | Örnek |
|---|---|---|
for, else |
Bir listeyi dolaşır; liste boşsa else çizilir. limit, offset ve reversed alır. |
{% for product in featured.products limit: 8 %}…{% endfor %} |
break |
Döngüden çıkar. | {% break %} |
continue |
Sonraki tura geçer. | {% continue %} |
cycle |
Her turda sıradaki değeri yazar. | {% cycle 'odd', 'even' %} |
tablerow |
Bir listeyi tablo satırları olarak yazar; cols alır. |
{% tablerow product in collection.products cols: 3 %}…{% endtablerow %} |
Yorum ve ham metin
| Etiket | Ne yapar | Örnek |
|---|---|---|
comment |
İçeriği çizmez. | {% comment %}…{% endcomment %} |
# |
Tek satırlık yorum. | {% # açıklama %} |
doc |
Parçanın belgesi; çizilmez. | {% doc %}…{% enddoc %} |
raw |
İçeriği Liquid olarak işlemeden yazar. | {% raw %}{{ olduğu gibi }}{% endraw %} |
Boşluk denetimi
{%-, -%}, {{- ve -}} ayraçları o yandaki boşluğu siler:
{%- if product.featured_media -%}
<div class="product__media">{{ product.featured_media | image_url: width: 800 | image_tag: loading: 'lazy' }}</div>
{%- endif -%}