<@cms_include>

模板引用标签

标签名

<@cms_include>

标签描述

引用其他模板内容，支持ssi引用标签

标签属性

属性名类型必填可用值描述默认值
fileSTRING是 引用模板文件路径（相对模板目录template/）
ssiBOOLEAN否true=是
false=否		是否启用SSItrue
virtualBOOLEAN否true=是
false=否		是否启用virtual模式，此模式下区块无法继承当前页面上限文变量，需要通过参数传入需要的变量false
cacheBOOLEAN否true=是
false=否		是否启用缓存true

使用示例

注意：include标签引用的模版默认会生成缓存，缓存时间1小时，如果需要强制更新可在后台模板管理菜单清理对应的模板缓存，或者修改include标签的cache属性为false关闭缓存机制。关闭后会对静态化效率产生一定的影响，取决于模板复杂程度。

示例1：页面公共头尾

<!-- header.template.html 是公共头部内容的独立模板 -->
<@cms_include file="header.template.html"></@cms_include>

示例2：给包含模板传递动态参数

传递动态参数有两种方式：

  1. 使用非SSI模式。可以在站点扩展配置关闭默认SSI开关，或者修改标签的ssi属性为false。
<@cms_include file="header.template.html?a=xx&b=yy" ssi="false"></@cms_include>

在header.template.html模板中可以通过一下方式获取请求参数

<div>
  请求参数a：${Request.a}
  请求参数b：${Request.b}
</div>
  1. 使用virtual模式。

由于此模式是在访问页面是实时解析的模版，因此模版无法获取父级模版的上下文数据，仅能获取到传递的参数。

<@cms_include file="header.template.html?a=xx&b=yy" virtual="true"></@cms_include>

内容导航