badqiu

XPer
随笔 - 46, 文章 - 3, 评论 - 195, 引用 - 0
数据加载中……

扩展freemarker,实现模板的继承

现扩展freemarker，新增加三个指令： @extends,@block,@override

一.目的

  • 父模板页面定义好布局,子模板可以重定义布局中的部分内容
  • 使模板可以实现类似"类"的继承关系,并不限继承层次

二.继承概榄

父模板: base.ftl
<html>  
    <head>  
        <@block name="head">base_head_content</@block>  
    </head>  
    <body>  
        <@block name="body">base_body_content</@block>  
    </body>  
</html>  
子模板child.ftl
<@override name="body">  
    <div class='content'>  
        Powered By rapid-framework  
    </div>  
</@override>  
<@extends name="base.flt"/> 

子模板child.ftl输出
<html>  
    <head>  
        base_head_content  
    </head>  
    <body>  
        <div class='content'>  
            Powered By rapid-framework  
        </div>  
    </body>  
</html> 
可以看到，body部分被重定义了，而head部分则还是显示父模板的内容。

三.指令介绍

  • @block : 定义块，可以被子模板用@override指令覆盖显示
  • @override :  覆盖@block指令显示的内容
  • @extends : 继承其它模板，必须放在模板的最后面（注：该指令完全等价于#include指令，只是为了提供统一的语义，即extends比include更好理解）

四.使用说明

要使用如上三个自定义指令，必须在freeemarker的Configuration中注册。使用如下代码：
configuration.setSharedVariable("block", new BlockDirective());  
configuration.setSharedVariable("override", new OverrideDirective());  
configuration.setSharedVariable("extends", new ExtendsDirective());  

以上三个指令属于rapid-framework的扩展，后续新版本发布将包含该项扩展，敬请关注。具体指令源码请查看:
  http://rapid-framework.googlecode.com/svn/trunk/rapid-framework/src/rapid_framework_common/cn/org/rapid_framework/freemarker/directive/

posted on 2009-12-22 23:47 badqiu 阅读(3768) 评论(1)  编辑  收藏


只有注册用户登录后才能发表评论。
网站导航: