判断函数(Is函数)

Is函数是一种特殊的函数，在指定的页或指定的函数的直接下一级有效。满足参数内的条件，则显示函数体内的内容，否则返回空。标准形式如下：

从以上结构中，可以看出，Is函数整体结构与标准函数是一致的。每次Is函数的调用，只有一个参数para，此参数允许有多个对应的值value1,value2...，多个参数值是“或”的关系，多个参数值之间以“,”分隔，只要多个参数值的其中之一满足条件则函数成立，否则返回空。

实例：

其中“First”为参数名，“1”为值，表示如果是第1页则显示，否则不显示。

实例：

其中“row”为参数名，“1”“2”为值，表示如果是第1行或第2行则显示，否则不显示。

Is函数的作用域：

Is函数有三种类型，一种是通用的，一种是针对模板页的，一种是针对模板函数的。

1. Is函数(通用，所有模板页有效)
   

   通用的Is函数，可以在所有模板页除函数内部的任意位置使用。
   示例代码：

   <!-- Begin:Is(guestbookverify:1) --> 显示留言验证码表单输入项 <!-- End:Is -->

   上面的代码用于判断是否显示验证码表单输入项。如果后台设置开启验证码功能，则显示一个输入验证码的输入框。如果后台关闭了此功能，则不显示。

   具体系统提供了哪些通用Is函数参数，您可以到通用Is函数章节查看。

2. Is函数(模板页提供)
   

   针对模板页的Is函数，可以在模板页除函数内部的任意位置使用。
   示例代码(ProductList模板页)：

   <!-- Begin:Is(First:1) --> 首页 <!-- End:Is --> <!-- Begin:Is(First:0) --> <a href="?t=ProductList&page=1">首页</a> <!-- End:Is --> <!-- Begin:ProductList(num:20) --> 商品名称：{Name} <!-- End:ProductList -->

   上面的代码在“ProductList”模板页用于自定义分页导航。表示：如果当前页是首页，则“首页”没链接；如果当前页不是首页，则“首页”链接到第一页。这边的Is函数参数“First”是由模板页“ProductList”提供的，所以其只能在页中使用，不能在兰色部分的函数内部使用。

   具体某一模板页提供了哪些Is函数参数，您可以到模板页章节查看。

3. Is函数(模板函数提供)
   

   针对模板函数提供的Is函数参数，可以在此函数的内部直接一级任意位置使用。

   示例代码(ProductTop模板函数)：

   <!-- Begin:ProductTop(num:2) --> <!-- Begin:Is(row:1) --> <img src="1.gif"> <!-- End:Is --> <!-- Begin:Is(row:2) --> <img src="2.gif"> <!-- End:Is --> 商品名称：{Name} <!-- End:ProductTop -->

   上面的代码在“ProductTop”模板函数用于显示排行榜。表示：如果是第一行，则显示一个“1.gif”的图标，如果是第二行则显示一个“2.gif”的图标。这边的Is函数参数“row”是由模板函数“ProductTop”提供的，所以其只能在其内部使用，不能在兰色部分的函数外部使用。

   具体某一模板函数提供了哪些Is函数参数，您可以到模板函数章节查看。

Is函数的特性：

1. 格式与极限模板函数的标准一致。见[函数结构]
2. 只能在提供者(模板页或模板函数)的直接内部有效。
3. 只有一个参数。参数成立则返回函数体内容，否则返回空。
4. 允许有多个参数值。多个参数值是“或”的关系，只要满足多个值之一则成立，否则返回空。
5. Is函数内部不允许再包含其它函数。
6. Is函数内部允许使用模板标签。