友好的开发框架-Asta4D(2):可继承的模板与参数化嵌入
<html> <head> <afd:block id="block1"> <link href="parent1.css" rel="stylesheet" type="text/css" /> </afd:block> <afd:block id="block2"> <link href="parent2.css" rel="stylesheet" type="text/css" /> </afd:block> <title>extension sample</title> </head> <body> <afd:block id="content">content</afd:block> </body> </html>
?
?
子模板child.html通过“afd:extension”声明继承关系,并利用“afd:block”声明覆盖动作:
?
?
<html> <head></head> <body> <!-- (1) --> <afd:extension parent="parent.html"> <!-- (2) --> <afd:block append="block1"> <link href="child1.css" rel="stylesheet" type="text/css" /> </afd:block> <!-- (3) --> <afd:block insert="block2"> <link href="child2.css" rel="stylesheet" type="text/css" /> </afd:block> <!-- (4) --> <afd:block override="content "> <div>hello</div> <!-- (5) --> <afd:embed target="/templates/embed.html" ></afd:embed> </afd:block> </afd:extension> </body> </html>
?
?
注意,“afd:block”支持声明三种类型的覆盖工作: 前追加(insert),后追加(append)以及完全覆盖(override)。在示例的子模板文件中的“afd:embed”声明了一个额外的include动作,即将target的模板文件嵌入到当前模板文件中,我们来看看embed.html:
?
<html> <head></head> <body> <!-- (6) --> <afd:block append="block1"> <link href="embed.css" rel="stylesheet" type="text/css" /> </afd:block> <div>good embed</div> </body> </html>
?
注意,当目标文件被嵌入后,目标文件中声明的afd:block标记同样有效,对被嵌入的文件来说,所有afd:block标记会被解释为对父模板的覆盖动作,而afd:block标记意外的部分,则被简单的嵌入到afd:embed声明的位置。
?
上述三个文件被模板引擎解释后,会得到如下的结果:
?
<html> <head> <!—block1 --> <link href="parent1.css" rel="stylesheet" type="text/css" /> <link href="child1.css" rel="stylesheet" type="text/css" /> <link href="embed.css" rel="stylesheet" type="text/css" /> <!—block2 --> <link href="child2.css" rel="stylesheet" type="text/css" /> <link href="parent2.css" rel="stylesheet" type="text/css" /> <title>extension sample</title> </head> <body> <!—content --> <div>hello</div> <!—embed --> <div>good embed</div> </body> </html>
?
2. 参数化嵌入
?
在通过afd:embed标记导入外部模板文件时,可以通过指定DOM属性的方式向外部模板文件传入参数:?
?
<afd:embed target="/xxx/showList.html" showLimit="30"></afd:embed>
?
上述例子中指定的showLimit参数在目标文件showList.html的渲染逻辑中可以通过参数注入访问,从而实现参数化渲染逻辑。这个特性对于定义页面组件非常有用,将通用的HTML片段封装起来通过embed引入,同时通过参数传递来控制行为,基本上来说,在模板中引用一个embed文件,类似于一次可传参的函数调用。特别需要指出的是,这里的参数并不限于在模板文件中静态指定,在运行时同样可以动态指定embed参数,而且,参数类型也不仅限于可字符串化的字符或者数值类型,在运行时动态指定的embed参数可以是任意Java类型。更详细的关于参数化嵌入的说明,可以参考后述的渲染逻辑的部分。?
?
3. 总结
简单的讲,Asta4D的模板思想类似于传统的OOP模式,可以将父子模板视同为父子类的关系,而block则可以被视作可覆盖的虚方法。至于embed的外部文件,可以视同函数调用,事实上,既然你可以向embed的文件传递任意类型的参数,因此它和函数调用的确没有什么区别。
?