26
2019.2

block块标签(模板继承)

作者: POPASP
模板继承是一项更加灵活的模板布局方式,模板继承不同于模板布局,甚至来说,应该在模板布局的上层。模板继承其实并不难理解,就好比类的继承一样,模板也可以定义一个基础模板(或者是布局),并且其中定义相关的区块(block),然后继承(extend)该基础模板的子模板中就可以对基础模板中定义的区块进行重载。 因此,模板继承的优势其实是设计基础模板中的区块(block)和子模板中替换这些区块。 ### 使用方法 每个区块由``标签组成,并且不支持block标签的嵌套。block标签中的内部块标签应直接从``开始。 下面就是基础模板中的一个典型的区块设计(用于设计网站标题): ```brush:html 网站标题 ``` block标签必须指定name属性来标识当前区块的名称,这个标识在当前模板中应该是唯一的,block标签中可以包含任何模板内容,包括其他标签和变量,例如: ```brush:html {$web_title} ``` 你甚至还可以在区块中加载外部文件: ```brush:html {include file="Public/header"} ``` 一个模板中可以定义任意多个名称标识不重复的区块,例如下面定义了一个base.html基础模板: ```brush:html 标题 菜单 左边分栏 主内容 右边分栏 底部 ``` 然后我们在子模板(其实是当前操作的入口模板)中使用继承: ```brush:html {extend file="base"} {$title} 首页 资讯 论坛 [@Title]
最新资讯: [@Title]
@POPASP2018 版权所有 ``` ### 实现原理 模板继承会生成解析文件,位置在`Runtime/Compile/`文件夹下,比如Index控制器的方法list,使用了模板继承后,会生成解析文件 ```brush:html Runtime/Compile/Index_list.txt ``` 在上例中,解析文件内容为 ```brush:html {$title} 首页 资讯 论坛 主内容 最新资讯: [@Title]
@POPASP2018 版权所有 ``` [![POPASP模板引擎模板继承流程](http://www.popasp.com/images/31/31_27_1.jpg "POPASP模板引擎模板继承流程")](http://www.popasp.com/images/31/31_27_1.jpg "POPASP模板引擎模板继承流程") 在开发模式中,每次都会进行替换,并且重新生成解析文件。在上线模式中,只会生成一次解析文件,以后每次都会引用该解析文件,而非模板文件,如果模板文件进行了修改,则会自动比对修改日期的先后顺序,而进行重新解析。这样的设计还包括模板布局与模板包含。 [![POPASP模板引擎模板继承流程](http://www.popasp.com/images/31/31_27_2.jpg "POPASP模板引擎模板继承流程")](http://www.popasp.com/images/31/31_27_2.jpg "POPASP模板引擎模板继承流程") 可以看到,子模板中使用了extend标签定义需要继承的模板,extend标签的用法和include标签一样,你也可以加载其他模板: ```brush:html {extend file="Public/base"} ``` ### 注意事项 在当前子模板中,只能定义区块而不能定义其他的模板内容,否则将会直接忽略,并且只能定义基础模板中已经定义的区块。 例如,如果采用下面的定义: ```brush:html {$title} 首页 资讯 论坛 ``` 导航部分将是无效的,不会显示在模板中。 在子模板中,可以对基础模板中的区块进行重载定义,如果没有重新定义的话,则表示沿用基础模板中的区块定义,如果定义了一个空的区块,则表示删除基础模板中的该区块内容。 上面的例子,我们就把left区块的内容删除了,其他的区块都进行了重载。 子模板中的区块定义顺序是随意的,模板继承的用法关键在于基础模板如何布局和设计规划了,如果结合原来的布局功能,则会更加灵活。 ### 不具备缓存功能 block块标签只起替换标识作用,并不具备像loopdb等块标签那样的缓存功能。所以它的格式为 ```brush:html 代码块 ``` 而下面的这种格式是错误的: ```brush:html 代码块 ``` 所以其内部代码,应该从`{`或``开始。