<stl:if> Conditional judgment

<stl:if
    type="测试类型"
    op="测试操作"
    value="测试值"
    context="所处上下文">
</stl:if>

说明

通过 stl:if 标签在模板中根据条件判断显示内容

stl:if 通常作为显示的判断条件，如果条件满足则显示，条件不满足则不显示。

stl:if 标签内可以嵌入任意代码，当条件满足时将显示嵌入的代码。如果需要根据测试是否成功显示不同的结果，需要使用子标签 <stl:yes> 和 <stl:no> ，测试条件成功时将显示 <stl:yes> 中的内容，测试条件失败时将显示 <stl:no> 中的内容。

type 属性指定测试类型，如测试栏目名称、模板名称、当前栏目是否属于指定栏目级别等。

如果需要判断自定义内容属性"XYZ"，也可以将type 设置为" XYZ"，系统将根据上下文判断栏目或内容的字段"XYZ"的值。

op 属性为测试操作，如是否值等于、不等于、大于、小于、属于等。

value 属性指定测试值，如op="Equals" value="123"（判断指定条件的值是否等于123）。

如果type为"AddDate"或"LastEditDate"，value可以采用时间段格式"数字+日期符号"，如"1y"、"3m"或"10d"，分别代表一年、三个月及十天内添加或编辑的内容。

<stl:if> 标签对应的实体为{stl:if}。

子标签

下表显示此标签所有的子标签。

子标签	说明
stl:yes	测试成功显示模板，可以省略
stl:no	测试失败显示模板，可以省略

属性

属性	说明
type	测试类型
op	测试操作
value	测试值
context	所处上下文

type - 测试类型

设置用于 if 测试的类型。

• "IsUserLoggin" 用户是否已登录
• "IsAdministratorLoggin" 管理员是否已登录
• "IsUserOrAdministratorLoggin" 用户或管理员是否已登录
• "UserGroup" 用户组
• "ChannelName" 栏目名称
• "ChannelIndex" 栏目索引
• "TemplateName" 模板名称
• "TemplateType" 模板类型，可能的 value 值：
  • "IndexPageTemplate" 首页模板
  • "ChannelTemplate" 栏目模板
  • "ContentTemplate" 内容模板
  • "FileTemplate" 单页模板
• "TopLevel" 栏目级别
• "UpChannel" 上级栏目
• "UpChannelOrSelf" 当前栏目或上级栏目
• "GroupChannel" 栏目组名称
• "GroupContent" 内容组名称
• "IsTop" 内容属性为置顶
• "IsRecommend" 内容属性为推荐
• "IsHot" 内容属性为热点
• "IsColor" 内容属性为醒目
• "CountOfContents" 内容数
• "CountOfImageContents" 图片内容数
• "CountOfChannels" 子栏目数
• "AddDate" 添加时间
• "LastEditDate" 最后编辑时间（仅用于判断内容）
• "ItemIndex" 当前项序号
• "OddItem" 是否为奇数项
• "自定义字符串" 栏目或内容的字段名称

op - 测试操作

设置用于 if 测试的比较操作。

• "Empty" 值为空
• "NotEmpty" 值不为空
• "Equals" 值等于
• "NotEquals" 值不等于
• "GreatThan" 值大于
• "LessThan" 值小于
• "In" 值属于
• "NotIn" 值不属于

value - 测试值

设置用于 if 测试的比较值。

context - 所处上下文

• "Content" 内容
• "Channel" 栏目
• "SqlContent" 获取数据库数据

示例

判断值是否为空

下面的例子判断内容副标题是否为空，如果不为空将显示带有副标题的行。

<stl:if type="SubTitle" op="NotEmpty">
  <strong>副标题：</strong><stl:content type="SubTitle"></stl:content>
</stl:if>

判断当前栏目名称

<stl:if type="ChannelName" op="In" value="栏目1,栏目2">
  <stl:yes> <p>true</p> </stl:yes>
  <stl:no> <p>false</p> </stl:no>
</stl:if>

根据模板类型显示不同内容

下面的例子判断当前模板是不是内容模板。

<stl:if type="TemplateType" op="Equals" value="ContentTemplate">
  <stl:yes>
      这是内容页面
  </stl:yes>
  <stl:no>
      这不是内容页面
  </stl:no>
</stl:if>

根据模板名称显示不同内容

下面的例子根据当前模板的模板名称显示不同的内容。

<stl:if type="TemplateName" op="Equals" value="系统首页模板">
  <stl:yes>
      <li><A href="/" class="current">首 页</A></li>
  </stl:yes>
  <stl:no>
      <li>我不是首页</li>
  </stl:no>
</stl:if>

突出显示10天内更新的内容

下面的例子显示整个站点中最新更新的 20 篇内容，并突出显示 10 天内更新的内容。

<stl:contents topLevel="0" totalNum="20" order="LastEditDate" scope="All">
  <stl:if type="LastEditDate" op="LessThan" value="10d">
      <stl:yes>
          <li><stl:a target="_blank" style="color:#F00;"></stl:a></li>
      </stl:yes>
      <stl:no>
          <li><stl:a target="_blank"></stl:a></li>
      </stl:no>
  </stl:if>
</stl:contents>

判断用户是否登录

下面的例子根据用户是否登录显示不同的内容

<stl:if type="IsUserLoggin">
    <stl:yes>
        欢迎"{user.displayName}"
        <stl:a href="{stl.HomeUrl}">用户中心</stl:a>
        <stl:a href="{stl.LogoutUrl}">退出</stl:a>
    </stl:yes>
    <stl:no>
        <stl:a href="{stl.LoginUrl}">登陆</stl:a>
        <stl:a href="{stl.RegisterUrl}">注册</stl:a>
    </stl:no>
</stl:if>