{% %}. Apenas as tags desta página existem — qualquer outra é erro e a
página não renderiza.
Controle de fluxo
if, elsif, else, unless, case/when, for, tablerow, cycle, break,
continue, assign, capture, increment, decrement, echo, liquid, comment,
# (comentário de linha) e raw. Ver exemplos em Sintaxe.
render: componentes
Inclui um componente, com variáveis próprias:
snippets/ → components/.
O componente enxerga as variáveis globais, os resultados de {% load %} e os parâmetros que
você passar. Variáveis criadas na página com assign/capture não chegam ao componente —
passe como parâmetro. {% include %} também existe e compartilha todas as variáveis da página.
layout e block
A página declara o layout na primeira linha; o resto dela entra no {% block %} do layout.
Parâmetros depois da vírgula viram variáveis dentro do layout:
layouts/layout.liquid
pages/index.liquid
{% block conteudo %}) só funcionam se o layout declarar um bloco com o
mesmo nome. Ver também o layout automático layouts/base.liquid em
Páginas.
section: blocos de layout
Renderiza sections/<nome>. O nome usa letras minúsculas, números, _ e -.
Profundidade máxima de aninhamento: 6.
hero, product-grid, benefits, announcement, category_carousel,
category_with_products. Uma seção que não existe ou que falha não aparece (sem erro).
tailwindcss
Insere o <link> do CSS do Tailwind gerado a partir do tailwind.config.json do tema:
load: dados dinâmicos
Carrega dados da loja direto no template. O resultado vira uma variável com o nome da
entidade, ou com o nome dado por as:
- Se o
loadfalhar (parâmetro inválido, tempo esgotado), a variável não é alterada. productepostnão encontrados viram uma lista vazia[], que é verdadeira em{% if %}— teste um campo:{% if produto.name %}.- Até 20
loadpor página, contando o layout declarado com{% layout %}(só olayouts/base.liquidtem os seus próprios 20). Os excedentes são ignorados. - O resultado vale na página, no layout, em
{% section %}e dentro de{% render %}.
Entidades disponíveis
Em
packages, size e total contam os itens desta página; o total do catálogo está
em meta.total. package_feedbacks e feedbacks criam variáveis com nomes fixos e
ignoram o as.orders (pedidos do cliente) não é carregado por load — é preenchido pela AllBay
nas páginas /account/*. Um {% load "orders" %} não altera esse valor.