mirror of
https://github.com/Shopify/liquid.git
synced 2026-09-15 08:50:45 -07:00
Samuel
9672ed5285
Example:
```
// the_count.liquid
{{ number }}! Ah ah ah.
// my_template.liquid
{% for number in range (1..3) %}
{% render "the_count", number: number %}
{% endfor %}
Output:
1! Ah ah ah.
2! Ah ah ah.
3! Ah ah ah.
```
The `render` tag is a more strict version of the `include` tag. It is
designed to isolate itself from the parent rendering context both by
creating a new scope (which does not inherit the parent scope) and by
only inheriting "static" registers.
Static registers are those that do not hold mutable state which could
affect rendering. This again helps `render`ed templates remain entirely
separate from their calling context.
Unlike `include`, `render` does not permit specifying the target
template using a variable, only a string literal. For example, this
means that `{% render my_dynamic_template %}` is invalid syntax. This
will make it possible to statically analyze the dependencies between
templates without making Turing angry.
Note that the `static_environment` of a rendered template is inherited, unlike
the scope and regular environment. This environment is immutable from within the
template.
An alternate syntax, which mimics the `{% include ... for %}` tag is
currently in design discussion.
28 lines
1.9 KiB
YAML
28 lines
1.9 KiB
YAML
---
|
|
errors:
|
|
syntax:
|
|
tag_unexpected_args: "Syntax Error in '%{tag}' - Valid syntax: %{tag}"
|
|
assign: "Syntax Error in 'assign' - Valid syntax: assign [var] = [source]"
|
|
capture: "Syntax Error in 'capture' - Valid syntax: capture [var]"
|
|
case: "Syntax Error in 'case' - Valid syntax: case [condition]"
|
|
case_invalid_when: "Syntax Error in tag 'case' - Valid when condition: {% when [condition] [or condition2...] %}"
|
|
case_invalid_else: "Syntax Error in tag 'case' - Valid else condition: {% else %} (no parameters) "
|
|
cycle: "Syntax Error in 'cycle' - Valid syntax: cycle [name :] var [, var2, var3 ...]"
|
|
for: "Syntax Error in 'for loop' - Valid syntax: for [item] in [collection]"
|
|
for_invalid_in: "For loops require an 'in' clause"
|
|
for_invalid_attribute: "Invalid attribute in for loop. Valid attributes are limit and offset"
|
|
if: "Syntax Error in tag 'if' - Valid syntax: if [expression]"
|
|
include: "Error in tag 'include' - Valid syntax: include '[template]' (with|for) [object|collection]"
|
|
unknown_tag: "Unknown tag '%{tag}'"
|
|
invalid_delimiter: "'%{tag}' is not a valid delimiter for %{block_name} tags. use %{block_delimiter}"
|
|
unexpected_else: "%{block_name} tag does not expect 'else' tag"
|
|
unexpected_outer_tag: "Unexpected outer '%{tag}' tag"
|
|
tag_termination: "Tag '%{token}' was not properly terminated with regexp: %{tag_end}"
|
|
variable_termination: "Variable '%{token}' was not properly terminated with regexp: %{tag_end}"
|
|
tag_never_closed: "'%{block_name}' tag was never closed"
|
|
meta_syntax_error: "Liquid syntax error: #{e.message}"
|
|
table_row: "Syntax Error in 'table_row loop' - Valid syntax: table_row [item] in [collection] cols=3"
|
|
render: "Syntax error in tag 'render' - Template name must be a quoted string"
|
|
argument:
|
|
include: "Argument error in tag 'include' - Illegal template name"
|