Themeleaf复用功能

Themeleaf复用功能

Thymeleaf 的复用功能能够有效减少代码冗余,提升开发效率,让代码更易于维护。以下为你详细介绍几种常见的复用功能:

1. 片段复用(Fragments)
定义片段

借助 th:fragment 指令,可将页面的部分代码定义成可复用的片段。片段能定义在单独的文件里,也可以和使用它的页面处于同一文件中。

示例:在 fragments.html 文件中定义片段:

scala 复制代码
html
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<body>
    <!-- 定义一个简单的头部片段 -->
    <div th:fragment="header">
        <h1>网站头部</h1>
    </div>
    <!-- 定义一个带参数的侧边栏片段 -->
    <div th:fragment="sidebar(title)">
        <h2 th:text="${title}">默认侧边栏标题</h2>
        <ul>
            <li>菜单项 1</li>
            <li>菜单项 2</li>
        </ul>
    </div>
</body>
</html>
使用片段

利用 th:replace 或者 th:insert 指令来引入片段。
th:replace 会用片段内容替换当前标签
th:insert 会把片段内容插入到当前标签内部。

示例:在 index.html 文件中使用上述片段:

scala 复制代码
html
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>首页</title>
</head>
<body>
    <!-- 引入头部片段 -->
    <div th:replace="fragments :: header"></div>
    <!-- 引入侧边栏片段并传递参数 -->
    <div th:replace="fragments :: sidebar(title='特色侧边栏')"></div>
    <p>这是首页的主要内容。</p>
</body>
</html>

2. 布局复用(Layouts)

定义布局模板

借助 Thymeleaf Layout Dialect 或者类似的扩展,能够创建布局模板,把页面的公共部分(像头部、底部、导航栏等)提取出来。

示例:创建 layout.html 布局模板:

scala 复制代码
html
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org"
      xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout">
<head>
    <title th:text="${title}">默认标题</title>
    <meta charset="UTF-8">
</head>
<body>
    <header>
        <h1>全局头部</h1>
    </header>
    <!-- 内容区域,子页面将替换此部分 -->
    <section layout:fragment="content">
        <p>默认内容</p>
    </section>
    <footer>
        <p>全局底部</p>
    </footer>
</body>
</html>
使用布局模板

在具体页面里使用 layout:decorate 指令指定要使用的布局模板,再用 layout:fragment 指令替换布局模板里的特定片段。

示例:创建 page.html 页面并使用布局模板:

scala 复制代码
html
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org"
      xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout"
      layout:decorate="~{layout}">
<head>
    <title>具体页面标题</title>
</head>
<body>
    <!-- 替换布局模板中的 content 片段 -->
    <section layout:fragment="content">
        <p>这是具体页面的内容。</p>
    </section>
</body>
</html>

3. 表达式复用

可以把常用的表达式提取到一个变量中,在需要的地方复用。

示例:

scala 复制代码
html
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>表达式复用示例</title>
</head>
<body>
    <!-- 定义一个表达式变量 -->
    <th:block th:with="user = ${session.user}">
        <p th:if="${user != null}" th:text="${'欢迎,' + user.name}">未登录</p>
        <p th:if="${user == null}">请登录</p>
    </th:block>
</body>
</html>

在这个示例中,th:with 指令定义了一个名为 user 的变量,用于存储 session.user 的值,后续在页面中能多次使用该变量,避免重复编写相同的表达式。

4. 消息复用

利用消息表达式(#{})和国际化资源文件,能够复用文本消息。

示例:

  1. 在 messages.properties 文件中定义消息:
scala 复制代码
properties
welcome.message=欢迎访问我们的网站!
  1. 在 HTML 页面中使用消息:
scala 复制代码
html
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>消息复用示例</title>
</head>
<body>
    <p th:text="#{welcome.message}">默认欢迎消息</p>
</body>
</html>
相关推荐
Mh5 小时前
我是如何设计品牌站组件库的?
前端·css·设计模式
程序员大阳5 小时前
副队长Vue3教程(2)--Vite 搭建 Vue 项目,认识目录结构
前端·javascript·vue.js·vite·创建项目·目录结构·项目结构
濮水大叔6 小时前
Cabloy/Zova 与 Next.js 的 SSR 水合差异
前端·typescript·next.js
SoaringHeart6 小时前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
Flynt7 小时前
Chrome给AI编程助手塞了203篇前端规范,我拆包实测:检索0.77秒是真快,扫描器有点挑食
前端·chrome·ai编程
北城笑笑8 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
yiangL_8 小时前
Python 学习笔记:递归、turtle绘图、字符串与函数
笔记·python·学习
程序员韩星8 小时前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http
Patrick_Wilson8 小时前
构建通过了,为什么有些浏览器还会白屏?
前端·javascript·浏览器
其实防守也摸鱼9 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构