1.注释
{# 这是注释内容 #}
{#
这是多行注释
#}
2.变量与控制
变量
可以直接使用变量 {{ value }}
也可以为对象或数组 {{ obj.key }} 、 {{ arr[0] }} 或 {{ arr[key] }}
也可以调用对象的方法 {{ obj.getName }}
也可以传参调用方法 {{ obj.getName(a,b) }}
当模版中使用{ { foo.bar }}时,PHP会做如下判断来检测对应变量的值:
- 检测foo是否是数组,并且bar是一个有效的KEY
- 如果foo为对象,则检测bar是否为有效的属性
- 如果foo为对象,但bar不是一个有效的属性,则检测bar是否为有效方法
- 如果foo为对象,但bar不是一个有效的方法,则检测getBar是否为有效方法
- 如果foo为对象,但getBar不是有效方法,则检测isBar是否为有效方法
- 如果没有,则返回null
其他:
设置默认值 { { 变量|default('默认值') }} 如果‘变量’为null,则输出‘默认值’
声明变量1 {% set 变量名 = 变量值 %}
{# 声明变量 foo #}
{% set foo = 'bar' %}
{# 输出变量 foo #}
{{ foo }}
{# 最终输出结果 bar #}
声明变量2 {% set 变量名 %} 变量值 {% endset %}
{% set foo %}
<div id="pagination">
...
</div>
{% endset %}
{# 实际为 foo = <div id="pagination"> ...</div> #}
选择
{% if 判断条件 %} 输出内容 {% endif %}:通过条件选择输出内容
//isShow为true或者false
{% if isShow %}
<p>isShow为true的时候显示本内容</p>
{% endif %}
//多个选择条件(比较符下一节进行介绍)
{% if temperature > 18 and temperature < 27 %}
<p>It's a nice day for a walk in the park.</p>
{% endif %}
//多重条件选择示例
{% if kenny.sick %}
Kenny is sick.
{% elseif kenny.dead %}
You killed Kenny! You bastard!!!
{% else %}
Kenny looks okay --- so far
{% endif %}
注意:
在判断条件里面,一些特殊数据格式的布尔值:
空字符串、数字0、空数组和null 的值都为 false;
只有空格的字符串、不为空的数组和对象都为 true;
循环
{% for 数组项 in 数组 %} 循环体 {% endfor %} :循环或遍历数组
{# 循环输出users数据集里的所有user的username熟悉 #}
{% for user in users %}
<li>{{ user.username|e }}</li>
{% endfor %}
{# 还可以利用'..'来输出0到10 和 a到z等 #}
{% for i in 0..10 %}
* {{ i }}
{% endfor %}
{% for letter in 'a'..'z' %}
* {{ letter }}
{% endfor %}
循环体内部(自带的)变量:
loop.index 循环的次数(从1开始)
loop.index0 循环的次数(从0开始)
loop.revindex 循环剩余次数(最小值为1)
loop.revindex0 循环剩余次数(最小值为0)
loop.first 当第一次循环的时候返回true
loop.last 当最后一次循环的时候返回true
loop.length 循环的总数
loop.parent 被循环的数组
3.运算和表达式
运算符
运算符号的优先级(高→低):
== != < > >= <= + - ~ * / // % ** | [] . .. and or not in is b-and b-or b-xor
其中,
~ 是 用于连接两个字符串,类似于PHP的‘.’
// 是 整除
** 是 乘方,类似于^
and or not 分别为并、或、非,分别相当于&&、||、!
b-and b-or b-xor 分别是位与、位或 和 位异或
- 是 减法以及去除空白的简写用法,如 { {- 数据 }} => 去除左边的空白、{ { 数据 -}} => 去除右边的空白、{ {- 数据 -}} => 去除两边的空白
(未完待续)
表达式
4.函数与过滤
函数
参数命名
过滤器
转义
{% autoescape %} xxx {% endautoescape %}:将字符串安全地处理成合法的指定数据
{% autoescape %}
无论自动转义启用与否,你都可以使用 autoescape 标签来标记模板的一部分进行转义或不转义
{% endautoescape %}
空白控制 spaceless
{% spaceless %} xxx {% endspaceless %}:减少 HTML 片段中的空格和换行
{% spaceless %}
<div>
<b>a b c</b>
</div>
{% endspaceless %}
{# 实际输出:<div><b>a b c</b></div> #}