一、前言

  • 为什么要使用模板页(Layout)

网站中往往有通用的布局,比如导航、底部等等,这些页面中共用的部分,就需要放在母版页(Layout)里面。
这样每个页面只用关注本页面要完成的功能/内容即可。提高了开发效率,也降低了公共部分的维护成本。

如果你还未使用过Freemarker,可以先阅读:使用Spring Boot+Freemarker模板引擎开发Web应用

二、实现方式

  • 母版页代码(resources/templates/shared/layout1.ftl)
<#macro layout>
<html>

<head>
    <title>${title} - Layout</title>
</head>

<body>
<div id="content">
    <#nested />
</div>
</body>

</html>
</#macro>
  • 子页面代码(resources/templates/demo/page1.ftl)
<#include "../shared/layout.ftl">

<@layout>
<div>这是子页面内容</div>
</@layout>

语法/标签说明

语法/标签 说明
macro 宏,用于包装Freemarker语句块/片段,可以被引用,在引用页,或者当前页都可以引用
<#macro layout> 指定macroid = layout
<#nested /> 嵌套,在macro标签内部使用,引用该macro时,<@macroid>标签包裹的内容会填充在<#nested />所在的位置
include 引用Freemarker模板文件
<@macroid> 引用macro,例如:<@macroid>,<@macroid>内容/@macroid
  • 控制器函数
@RequestMapping("/page1")
ModelAndView page1(){
    ModelAndView mv = new ModelAndView();
    mv.addObject("title","子页面标题");
    mv.setViewName("demo/page1");
    return mv;
}

最终的渲染结果是:



<html>

<head>
    <title>子页面标题 - Layout</title>
</head>

<body>
<div id="content">
<div>这是子页面内容</div>
</div>
</body>

</html>