ThinkPHP3.2.3循环和控制输出


在上一章我们了解了如何把变量输出到模板中,这一篇我们来进一步了解如何进行模板数据的循环和控制输出。

注意,本篇的描述仅针对使用内部模板引擎的情况,如果你使用了Smarty或者其他模板引擎,请参考其相关的变量输出语法。

循环输出

循环输出主要是使用volist和foreach标签输出。

VOLIST

volist标签通常用于查询数据集(select方法)的结果输出,通常模型的select方法返回的结果是一个二维数组,可以直接使用volist标签进行输出。

在控制器中首先对模版赋值:

$User = M('User');
$list = $User->limit(10)->select();
$this->assign('list',$list);

在模版定义如下,循环输出用户的编号和姓名:

<volist name="list" id="vo">{$vo.id}:{$vo.name}<br/></volist>

Volist标签的name属性表示模板赋值的变量名称,因此不可随意在模板文件中改变。id表示当前的循环变量,可以随意指定,但确保不要和name属性冲突,例如:

<volist name="list" id="data">{$data.id}:{$data.name}<br/></volist>

支持输出查询结果中的部分数据,例如输出其中的第5~15条记录

<volist name="list" id="vo" offset="5" length='10'>{$vo.name}</volist>

输出偶数记录

<volist name="list" id="vo" mod="2" ><eq name="mod" value="1">{$vo.name}</eq></volist>

Mod属性还用于控制一定记录的换行,例如:

<volist name="list" id="vo" mod="5" >{$vo.name}<eq name="mod" value="4"><br/></eq></volist>

为空的时候输出提示:

<volist name="list" id="vo" empty="暂时没有数据" >
{$vo.id}|{$vo.name}
</volist>

empty属性不支持直接传入html语法,但可以支持变量输出,例如:

$this->assign('empty','<span class="empty">没有数据</span>');$this->assign('list',$list);

然后在模板中使用:

<volist name="list" id="vo" empty="$empty" >
{$vo.id}|{$vo.name}
</volist>

模板中可以直接使用函数设定数据集,而不需要在控制器中给模板变量赋值传入数据集变量,如:

<volist name=":fun('arg')" id="vo">{$vo.name}</volist>

FOREACH

除了volist标签之外,还可以使用foreach标签,foreach标签类似与volist标签,只是更加简单,没有太多额外的属性,例如:

<foreach name="list" item="vo">
    {$vo.id}:{$vo.name}
</foreach>

name表示数据源 item表示循环变量。
foreach标签还可以输出一维数组,例如:

<foreach name="list" item="vo" >
    {$key}|{$vo}
</foreach>

条件输出

条件输出最常用的包括switch、if以及eq等比较标签。

SWITCH

用法:

<switch name="变量" >
<case value="值1" break="0或1">输出内容1</case>
<case value="值2">输出内容2</case>
<default />默认情况
</switch>

使用方法如下:

<switch name="User.level">
    <case value="1">value1</case>
    <case value="2">value2</case>
    <default />default</switch>

其中name属性可以使用函数以及系统变量,例如:

<switch name="Think.get.userId|abs">
    <case value="1">admin</case>
    <default />default</switch>

对于case的value属性可以支持多个条件的判断,使用”|”进行分割,例如:

<switch name="Think.get.type">
    <case value="gif|png|jpg">图像格式</case>
    <default />其他格式
</switch>

表示如果$_GET["type"] 是gif、png或者jpg的话,就判断为图像格式。

Case标签还有一个break属性,表示是否需要break,默认是会自动添加break,如果不要break,可以使用:

<switch name="Think.get.userId|abs">
    <case value="1" break="0">admin</case>
    <case value="2">admin</case>
    <default />default</switch>

也可以对case的value属性使用变量,例如:

<switch name="User.userId">
    <case value="$adminId">admin</case>
    <case value="$memberId">member</case>
    <default />default</switch>

比较标签

比较标签用于简单的变量比较,复杂的判断条件可以用if标签替换,比较标签是一组标签的集合,基本上用法都一致,如下:

<比较标签 name="变量" value="值">内容</比较标签>

系统支持的比较标签以及所表示的含义分别是:

标签含义
eq或者 equal等于
neq 或者notequal不等于
gt大于
egt大于等于
lt小于
elt小于等于
heq恒等于
nheq不恒等于

他们的用法基本是一致的,区别在于判断的条件不同,并且所有的比较标签都可以和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>

当 name变量的值大于5就输出

<gt name="name" value="5">value</gt>

当name变量的值不小于5就输出

<egt name="name" value="5">value</egt>

比较标签中的变量可以支持对象的属性或者数组,甚至可以是系统变量,例如:
当vo对象的属性(或者数组,或者自动判断)等于5就输出

<eq name="vo.name" value="5">{$vo.name}</eq>

当vo对象的属性等于5就输出

<eq name="vo:name" value="5">{$vo.name}</eq>

当$vo['name']等于5就输出

<eq name="vo['name']" value="5">{$vo.name}</eq>

而且还可以支持对变量使用函数
当vo对象的属性值的字符串长度等于5就输出

<eq name="vo:name|strlen" value="5">{$vo.name}</eq>

变量名可以支持系统变量的方式,例如:

<eq name="Think.get.name" value="value">相等<else/>不相等</eq>

通常比较标签的值是一个字符串或者数字,如果需要使用变量,只需要在前面添加“$”标志:
当vo对象的属性等于$a就输出

<eq name="vo:name" value="$a">{$vo.name}</eq>

范围判断标签

范围判断标签包括innotinbetweennotbetween四个标签,都用于判断变量是否中某个范围。

IN和NOTIN

用法:
假设我们中控制器中给id赋值为1:

$id =    1;
$this->assign('id',$id);

我们可以使用in标签来判断模板变量是否在某个范围内,例如:

<in name="id" value="1,2,3">
id在范围内
</in>

最后会输出:id在范围内

如果判断不在某个范围内,可以使用:

<notin name="id" value="1,2,3">id不在范围内</notin>

可以把上面两个标签合并成为:

<in name="id" value="1,2,3">
id在范围内
<else/>
id不在范围内
</in>

name属性还可以支持直接判断系统变量,例如:

<in name="Think.get.id" value="1,2,3">$_GET['id'] 
在范围内
</in>

value属性也可以使用变量,例如:

<in name="id" value="$range">
id在范围内
</in>

$range变量可以是数组,也可以是以逗号分隔的字符串。

BETWEEN 和 NOTBETWEEN

可以使用between标签来判断变量是否在某个区间范围内,可以使用:

<between name="id" value="1,10">输出内容1</between>

同样,可以使用notbetween标签来判断变量不在某个范围内:

<notbetween name="id" value="1,10">输出内容2</notbetween>

也可以使用else标签把两个用法合并,例如:

<between name="id" value="1,10">输出内容1<else/>输出内容2</between>

当使用between标签的时候,value只需要一个区间范围,也就是只支持两个值,后面的值无效,例如

<between name="id" value="1,3,10">输出内容1</between>

实际判断的范围区间是1~3,而不是1~10,也可以支持字符串判断,例如:

<between name="id" value="A,Z">输出内容1</between>

name属性可以直接使用系统变量,例如:

<between name="Think.post.id" value="1,5">输出内容1</between>

value属性也可以使用变量,例如:

<between name="id" value="$range">输出内容1</between>

赋值判断标签

可以使用present、empty等标签进行赋值判断输出。

present标签用于判断某个变量是否已经定义,用法:

<present name="name">name已经赋值<else /> name还没有赋值</present>

name属性可以直接使用系统变量,例如:

<present name="Think.get.name">$_GET['name']已经赋值
</present>

empty标签用于判断某个变量是否为空,用法:

name为空

name不为空

name属性可以直接使用系统变量,例如:

<empty name="Think.get.name">$_GET['name']为空值
</empty>

DEFINED标签用于判断某个常量是否有定义,用法如下:

<defined name="NAME">NAME常量已经定义<else /> NAME常量未定义</defined>

原生代码

Php代码可以和标签在模板文件中混合使用,可以在模板文件里面书写任意的PHP语句代码 ,包括下面两种方式:

第一种:使用php标签

例如:

<php>echo 'Hello,world!';</php>

我们建议需要使用PHP代码的时候尽量采用php标签,因为原生的PHP语法可能会被配置禁用而导致解析错误。

第二种:使用原生php代码

<?php echo 'Hello,world!'; ?>

总结

本章我们讲述了模板中进行循环和控制输出,下一篇我们还会讲述如何使用公共模板和布局模板来简化模板文件的定义。