Jingoo - Template designer documentation

Itérer sur chaque élément d'une séquence.

A l'intérieur d'une boucle for, vous pouvez acceder à certaines variables automatiques :

loop.index: L'index courant de la boucle, en commençant à 1.
loop.index0: L'index courant de la boucle, en commençant à 0.
loop.revindex: Le nombre d'itération restantes jusqu'à la fin. Retourne 1 lors de la dernière itération.
loop.revindex0: Le nombre d'itération restantes jusqu'à la fin. Retourne 0 lors de la dernière itération.
loop.first: <code>true</code> lors de la première iteration uniquement.
loop.last: <code>true</code> lors de la dernière iteration uniquement.
loop.length: Le nombre total d'éléments dans la séquence.
loop.cycle: Une fontion pour cycler sur une séquence donnée en paramètre (c.f. l'exemple ci-dessous).

MODELS JINGOO RESULT

{{ { links: [ [ "http://yahoo.co.jp", "yahoo japan" ],
	      [ "http://google.co.jp", "google japan" ] ],
     links2:[ ("http://yahoo.co.jp", "yahoo japan"),
              ("http://google.co.jp", "google japan") ],
     obj: { name: "alice", age: 42, sex: "F" },
     str1: "abc",
     str2: "日本語"
   } }}

{%- for item in [ 0, 1, 2, 3, 4, 5 ] -%}
  - {{ item }}: {{ loop.cycle (["even","odd"]) }}
{% endfor -%}
{%- for item in links -%}
<a href="{{ item[0] }}">{{ item[1] }}</a>
{% endfor -%}
{%- for (href, title) in links2 -%}
<a href="{{ href }}">{{ title }}</a>
{% endfor -%}
{%- for (key, value) in obj -%}
  - {{ key }}: {{ value }}
{% endfor -%}
{% for s in str1 -%}
  {{ s }}({{ loop.index }})
{% endfor -%}
{% for s in str2 -%}
{{ s }}({{ loop.index }})
{% endfor -%}

- 0: even
- 1: odd
- 2: even
- 3: odd
- 4: even
- 5: odd
<a href="http://yahoo.co.jp">yahoo japan</a>
<a href="http://google.co.jp">google japan</a>
<a href="http://yahoo.co.jp">yahoo japan</a>
<a href="http://google.co.jp">google japan</a>
- name: alice
- age: 42
- sex: F
a(1)
b(2)
c(3)
日(1)
本(2)
語(3)

Macro are useful to put often used idioms into reusable component.

Note that macros are hoisted, and their scope is the toplevel scope. It means that you define two macro with the same name, the second will erase the first, even in the macro invocation occuring before the second definition.

Optionally, you can repeat the name of the macro in the endmacro part.

Use call statement to pass a macro to another macro.

Function can be seen as macros that return a value instead of printing it.

JINGOO RESULT

{% function incr (i) %}{{i+1}}{% endfunction -%}
incr(1) = {{ incr (1) }}
incr(-1) = {{ incr (-1) }}

{% function lt1 (i) %}{{ i < 1 }}{% endfunction -%}
lt1(1) = {{ lt1 (1) }}
lt1(-1) = {{ lt1 (-1) }}

{% function obj (x, y) %}{{ {a:x,b:y} }}{% endfunction -%}

obj(1,2).a = {{ obj(1,2).a }}
obj(1,2).b = {{ obj(1,2).b }}

obj('a',2.5).a = {{ obj('a',2.5).a }}
obj('a',2.5).b = {{ obj('a',2.5).b }}

{% function inv (reverse=false, x, y) -%}
  {%- if reverse %}{{ {a:y,b:x} }}{% else %}{{ {a:x,b:y} }}{% endif -%}
{%- endfunction -%}

inv('a','b').a = {{ (inv('a','b')).a }}
inv(reverse=true,'a','b').a = {{ (inv(reverse=true,'a','b')).a }}

{% function add_val (val=0, x) -%}
  {{ [ x, (x + val) ] }}
{%- endfunction -%}
{% for x in [-1,0,1,2] | map (add_val, val=-2) -%}
  add_val(val=-2,{{x[0]}}) = {{x[1]}}
{% endfor -%}

{% function const () -%}{{ 4 }}{% endfunction -%}

const() = {{ const () }}

incr(1) = 2
incr(-1) = 0

lt1(1) = false
lt1(-1) = true

obj(1,2).a = 1
obj(1,2).b = 2

obj('a',2.5).a = a
obj('a',2.5).b = 2.5

inv('a','b').a = a
inv(reverse=true,'a','b').a = b

add_val(val=-2,-1) = -3
add_val(val=-2,0) = -2
add_val(val=-2,1) = -1
add_val(val=-2,2) = 0
const() = 4

The if statement allows us to check if an expression is true or false, and execute different code according to the result.

0, null, '', "", [], or {} are considered as false when used in a if/elif test. The rest is true.

The switch statement allows us to use compare a variable with a set of literal values.

Lors de l'assignement d'une variable dans un block, la portée de cette dernière se limite au block dans lequel elle a été défini (et à ses blocks enfants). C'est à dire que vous pouvez accéder aux variables définies dans un block parent, mais pas les redfinir. Une affectation masquera l'ancienne définition de la variable tant que vous ne serez au sein du block courant, mais à l'exterieur du block, la variable sera toujours affectée à l'ancienne valeur.

Seuls les blocks if dérogent à la règle et modifie la variable du scope parent.

Voyez les namespaces pour des utiliser des variables modifiable par les blocks enfants.

Les namespaces peuvent être utilisés pour créer des variables modifiables depuis un block enfant.

Use {%- to strip whitespaces before this token.

Use -%} to strip whitespaces after this token.

Tests can be used with the standard function call syntax, but also with the is keyword in statements or expressions.

L'évaluation des tests booléens est séquentiel, de gauche à droite.

Dans e1 && e2, e1 est évalué, et si e1 retourne false, e2 n'est pas évalué du tout.

Dans e1 || e2, e1 est évalué, et si e1 retourne true, e2 n'est pas évalué du tout.

Utilisez les opérateurs not et ! pour inverser un booléen.

The fat arrow operator => is used to define anonymous functions.

It is right associative and have the lowest precedence of all the operators.