模板手册

模板指令(标签)

<@cms_include>

<@cms_include>

模板引用标签

标签名

<@cms_include>

标签描述

引用其他模板内容,支持ssi引用,支持动态引用。

标签属性

属性名类型必填可用值描述
fileSTRING引用模板文件路径(相对模板目录template/)
ssiBOOLEANtrue=是,false=否是否启用SSI
未设置时读取站点配置
默认:true
virtualBOOLEANtrue=是,false=否是否启用virtual
此模式下区块无法继承当前页面上下文变量,需要通过参数传入需要的变量
默认:false
cacheBOOLEANtrue=是,false=否是否启用缓存
默认:true

用法示例

示例1

使用场景1:公共页头

<@cms_include file="header.template.html"></@cms_include>

示例2

使用场景:栏目侧边栏动态热点内容区块,针对页面某区块内容需要获取实时数据。

<@cms_include 
  file="block_hot.template.html?cid=${Catalog.catalogId}" 
  virtual="true"
></@cms_include>

热点区块模板block_hot.template.html示例:

<@cms_content catalogid="${IncludeRequest.cid}" level="CurrentAndChild" hasattribute="hot" sort="Recent">
  <#list DataList as content>
    <a href="${content.link}">${content.title}</a>
  </#list>
</@cms_content>