ThinkPHP6 模板引擎普通标签中,模板引擎运算符函数,循环标签,判断标签的使用,及一些特殊标签
模板引擎支持普通标签和XML标签方式两种标签定义,分别用于不同的目的:
这种方式的结合保证了模板引擎的简洁和强大的有效融合。
模板文件可以同时包含普通标签和标签库标签,标签的定界符都可以重新配置。
普通标签
普通标签用于变量输出和模板注释,普通模板标签默认以{
和}
作为开始和结束标识,并且在开始标记紧跟标签的定义,如果之间有空格或者换行则被视为非模板标签直接输出。 例如:{$name}
、{$vo.name}
、{$vo['name']|strtoupper}
都属于正确的标签,而{ $name}
、{ $vo.name}
则不属于。
普通标签中支持函数,注释,加减乘除的运算符及三目运算符…
运算符,函数
1. 运算符
可以对模板输出使用运算符,包括如下支持。
示例:模板引擎运算符的使用
后端部分
<?phpnamespace app\controller;use app\BaseController;use think\facade\View; // 使用模板引擎class Index extends BaseController{public function index(){view::assign('a',30);view::assign('b',5);return view::fetch();}}
视图部分:
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>Title</title></head><body><p> a+b={$a+$b}</p><p> a-b={$a-$b}</p><p> a*b={$a*$b}</p><p> a/b={$a/$b}</p><p> a++={$a++}</p><p> a--={$a--}</p></body></html>
2. 函数
系统内置了下面几个固定的过滤规则(不区分大小写)
示例:模板引擎函数的使用
后端
<?phpnamespace app\controller;use app\BaseController;use think\facade\View; // 使用模板引擎class Index extends BaseController{public function index(){view::assign('now',time());view::assign('strs','abcd0123jk');view::assign('pwd','SOLO');return view::fetch();}}
视图
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>Title</title></head><body><p> {$now|date="y-m-d h:m:s"}</p><p>{$strs|substr=0,3}</p><p>{$strs|upper}</p><p>{$strs|lower}</p><p>{$pwd|md5}</p></body></html>
模板引擎函数使用其实就是 {data|过滤规则(函数名)}
注释
1. 单行注释
格式:
{/\* 注释内容 \*/ } 或 {// 注释内容 }
例如:
{// 这是模板注释内容 }
注意
{
和注释标记之间不能有空格。
2. 多行注释
支持多行注释,例如:
{/* 这是模板注释内容*/ }
模板注释支持多行,模板注释在生成编译缓存文件后会自动删除(即前端看不到),这一点和Html的注释不同。
循环标签
1. foreach
foreach标签语法规范,和php的foreach一模一样,只是开始结束标记不同,也可以单独遍历key或者value。foreach标记用于遍历输出数组的元素或者对象的属性。
{foreach $数组名 as $k=>$v}<div><p>{$v['键名']}</p></div>{foreach/}
首先,我们从控制器返回给视图层一些数据,比如说一个用户数组
<?phpnamespace app\controller;use app\BaseController;use think\facade\View; // 使用模板引擎class Index extends BaseController{public function index(){$arr =[['name'=>'张三','age'=>30,'gender'=>'男'],['name'=>'王五','age'=>33,'gender'=>'男'],['name'=>'李四','age'=>26,'gender'=>'男']];view::assign('arr',$arr);return view::fetch();}}
第二步,在视图页面利用foreach标签将数据循环渲染
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>Title</title></head><body><h1>我是index页</h1>{foreach $arr as $v}<div><p>姓名:{$v['name']}</p><p>年龄:{$v['age']}</p><p>性别:{$v['gender']}</p></div>{/foreach}</body></html>
foreach 标签使用和php中的foreach几乎完全一样,只是写法略有区别,我们将上面的前端代码进行修改如下,将对应的索引下标也渲染出来。
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>Title</title></head><body><h1>我是index页</h1>{foreach $arr as $k=>$v}<div><h3>{$k}</h3><p>姓名:{$v['name']}</p><p>年龄:{$v['age']}</p><p>性别:{$v['gender']}</p></div>{/foreach}</body></html>
2. volist
volist
标签通常用于查询数据集或者二维数组的结果输出。
volist语法规范:
{volist name="arr" id="v" key="k" offset="1" length="2"}<div><p>{$k}----${v['键名']}</p></div>{/volist}
volist标记中的属性值解释如下:
name 模板赋值的变量名称 (即你后端传递过来的变量名)id 当前的循环变量,随意起名key 下标,从1开始,如果不显式的声明的话,默认通过变量i来获取offset 开始行数length 获取行数,输出的循环元素的个数的长度empty 如果数据为空,显示此文字
为了简单,就使用上面的foreach标记的后端传递的参数,将前端代码修改即可。
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>Title</title></head><body><h1>我是index页</h1>{foreach $arr as $k=>$v}<div><h3>{$k}</h3><p>姓名:{$v['name']}</p><p>年龄:{$v['age']}</p><p>性别:{$v['gender']}</p></div>{/foreach}<!-- 新增部分 volist --><hr>{volist name="arr" id="item" key="key"}<div><h3>{$key}</h3><p>姓名:{$item['name']}</p><p>年龄:{$item['age']}</p><p>性别:{$item['gender']}</p></div>{/volist}</body></html>
volist 标记和foreach 标记也差不多,只是需要通过name来指明要循环的变量,id来确定每次循环的变量名,然后提供了更灵活的offset和length属性,可以根据不同的需求,进行不同的循环渲染,最后就是foreach标记中索引下标从0开始,volist标记索引下标从1开始。
3. for
for标记用法:
{for start="开始值" end="结束值" comparison="" step="步进值" name="循环变量名" }<p>{$循环变量名}</p>{/for}
开始值、结束值、步进值和循环变量都可以支持变量,开始值和结束值是必须,其他是可选。comparison 的默认值是lt,name的默认值是i,步进值的默认值是1。
这里就简单的输出一个1-10的循环把,每次步长为2
<!-- for标记 -->{for start="0" end="10" step="2"}<p>{$i}</p>{/for}
判断标签
比较标签用于简单的变量比较,复杂的判断条件可以用if标签替换,比较标签是一组标签的集合,基本上用法都一致,如下:
{比较标签 name="变量" value="值"}内容{/比较标签}
系统支持的比较标签以及所表示的含义分别是:
他们的用法基本是一致的,区别在于判断的条件不同,并且所有的比较标签都可以和else标签一起使用。
例如,要求name变量的值等于value就输出,可以使用:
{eq name="name" value="value"}value{/eq}
或者
{equal name="name" value="value"}value{/equal}
也可以支持和else标签混合使用:
{eq name="name" value="value"}相等{else/}不相等{/eq}
…其余上述标签用法都差不多,实际的用例可以参考tp5完全开发手册的标签。
1. if 标签
if标记用法规范:
{if 表达式}value1{elseif 表达式 /}value2{else /}value3{/if}
示例:
同样的我们先从后端传递一些数据过去
<?phpnamespace app\controller;use app\BaseController;use think\facade\View; // 使用模板引擎class Index extends BaseController{public function index(){$status = 0;$light = 1;view::assign('status',$status);view::assign('light',$light);return view::fetch();}}
视图部分
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>Title</title></head><body>{if ($status==1)}管理员{else/} 普通用户{/if}<hr>{if ($light>0)}绿灯{elseif ($light==0)}黄灯{else($light<0)}红灯{/if}</body></html>
2. switch 标签
switch标记用法规范:
{switch 变量 }{case value1 }输出内容1{/case}{case value2}输出内容2{/case}{default /}默认情况{/switch}
示例:依旧使用上面if标记的后端数据,只是将红绿的if块改为switch块
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>Title</title></head><body>{if ($status==1)}管理员{else/} 普通用户{/if}<hr>{switch $light}{case $light>0}绿灯{/case}{case 0}黄灯{/case}{case $light<0}红灯{/case}{/switch}</body></html>
特殊标签
1. literal 防止解析(原样输出)标签
有些时候,我们不希望模板引擎将模板变量解析,那么就可以使用literal标记
{literal}Hello,{$name}!{/literal}
上面的{$name}
标签被literal
标签包含,因此并不会被模板引擎解析,而是保持原样输出。
literal
标签还可以用于页面的JS代码外层,确保JS代码中的某些用法和模板引擎不产生混淆。
总之,所有可能和内置模板引擎的解析规则冲突的地方都可以使用literal
标签处理。
2. php 标签
Php代码可以和标签在模板文件中混合使用,可以在模板文件里面书写任意的PHP语句代码 :
例如:
{php}echo 'Hello,world!';{/php}
建议需要使用PHP代码的时候尽量采用php标签,因为原生的PHP语法可能会被配置禁用而导致解析错误。
小结
模板引擎提供了运算符,函数,可以在前端更灵活的去编写不同的代码。
函数的使用规则模板引擎函数使用其实就是 {data|过滤规则(函数名)}。
模板引擎注释,单行注释和多行注释与php一致,只是在{} 大括号中间,且并不会被前端代码解析。
模板引擎循环标签,提供了三种方式,foreach,volist,for,其中volist最为灵活。
模板引擎判断标签,只能说应有尽有,{if}{elseif}{else/}{/if},{switch}{case}{/case}{/switch}…
一些特殊标记,literal原样输出标记,php标记与<?php ?>
功能一样,更推荐使用php标记。
ThinkPHP6 模板引擎普通标签中 模板引擎运算符函数 循环标签 判断标签的使用 及一些特殊标签